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Server Support APIs 


The Server Support APIs include: 
@ iSeries Support for Windows Network Neighborhood Server APIs 


e Integrated Operating Environments APIs 


Dynamic Host Configuration Protocol Server 
Exit Programs 


The iSeries Dynamic Host Configuration Protocol (DHCP) server assigns and releases TCP/IP addresses 
from client hosts in a network. Exit points have been provided so that user-written programs can be called 
from the running DHCP server. They allow for customer-supplied security validation of incoming client 
requests, as well as notification when IP addresses are assigned or released. 


The DHCP Request Packet Validation exit program allows for incoming client request packets to be 
screened by a user program that starts any processing on it. The user program is able to communicate back 
to the DHCP server that either the packet should be discarded or that it should be allowed to process. 


The Address Binding Notification exit program and the Address Release Notification exit program are for 
notification purposes only. These allow for user applications to keep track of which IP addresses are 
currently in use and by which clients. 


The Dynamic Host Configuration Protocol Server exit programs are: 


e DHCP Address Binding Notification allows for notification each time the Dynamic Host 
Configuration Protocol (DHCP) server assigns an IP address to a specific host. 


e DHCP Address Release Notification allows for notification each time the DHCP server releases an 
IP address from its specific client host assignment binding. 


e DHCP Request Packet Validation provides additional control for restricting which incoming DHCP 


and Bootstrap Protocol (BOOTP) message request packets from client hosts are processed by their 
DHCP server, and which are rejected. 


Top | APIs by category 


iSeries Support for Windows Network 
Neighborhood Server APIs 


The iSeries Support for Windows Network Neighborhood Server (iSeries NetServer) APIs allow personal 
computers to access file and print resources on the iSeries by using the networking support provided with 
their operating systems. Operating systems that are supported by iSeries NetServer include Windows 95, 
Windows 98/Me, Windows NT 4.0, Windows 2000, Windows XP, and Linux/Samba. 


For more information, see the iSeries NetServer topic. 


The iSeries NetServer APIs and their functions are: 


Add File Server Share (QZLSADFS) shares a portion of the integrated file system with the network 
using the iSeries Support for Windows Network Neighborhood server. 

Add Print Server Share (QZLSADPS) shares an output queue with the network by using the iSeries 
Support for Windows Network Neighborhood server. 

Change File Server Share (QZLSCHFS) changes the information about a shared portion of the 
integrated file system. 


Change Print Server Share (QZLSCHPS) changes the information about a shared printer. 


Change Server Guest (QZLSCHSG) changes the user profile used by the iSeries Support for 
Windows Network Neighborhood server when an unknown user requests access to shared 
resources on the system. 


Change Server Information (QZLSCHSD changes general configuration information for the iSeries 
Support for Windows Network Neighborhood server. 


Change Server Name (QZLSCHSN) changes the name by which the iSeries Support for Windows 
Network Neighborhood server is known on the network. 

End Server (QZLSENDS) ends the jobs that support the iSeries Support for Windows Network 
Neighborhood server. 

End Server Session (QZLSENSS) ends a single session or all the sessions that were established 
from the specified workstation. 


List Server Information (QZLSLSTD lists information about the server for configuration, 
connections, sessions, shares, or statistical information. 


Open List of Server Information (QZLSOLST) opens a list of information about the server for 
share, configuration, session, connection, or statistical information. 


Remove Server Share (QZLSRMS) removes a share from the list of files or printers on the server. 


Start Server (QZLSSTRS) starts the jobs necessary for the iSeries Support for Windows Network 
Neighborhood server to run. 
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Add File Server Share (QZLSADFS) API 


Required Parameter Group: 


Share name Char(12) 
Path name Char(*) 

Length of path name Binary(4) 
CCSID encoding of path name Binary(4) 
Text description Char(50) 
Permissions Binary(4) 
Maximum users Binary(4) 
Error code Char(*) 


1 
2, 
3 
4 
5 
6 
7 
8 


Optional Parameter Group: 


CCSID used for text conversion Binary(4) 
Enable text conversion Char(1) 
File extension table Char(*) 
Number of table entries Binary(4) 


Default Public Authority: *USE 


Threadsafe: No 


The Add File Server Share (QZLSADFS) API shares a portion of the integrated file system with the 
network using the iSeries Support for Windows Network Neighborhood server. 


Authorities and Locks 


To use this API, you must have *IOSYSCFG special authority or own the integrated file system directory. 


Required Parameter Group 


Share name 
INPUT; CHAR(12) 


The name of the share to be added. 
Path name 
INPUT; CHAR(*) 
The path in the integrated file system to be shared with the network. A forward slash, '/', is required 
as the first character. 


Length of path name 


INPUT; BINARY(4) 


The length, in bytes, of the path name. The maximum length is 1024 bytes. 
CCSID encoding of path name 
INPUT; BINARY(4) 
The coded character set ID (CCSID) of the path name and the file extension table entries. 0 will 
result in the current job CCSID being used. 
Text description 
INPUT; CHAR(50) 


The text description for this share. 
Permissions 
INPUT; BINARY(4) 


The access available from the network for this share. 
I Read only 
2 Read/Write 


Maximum users 
INPUT; BINARY(4) 


The maximum number of users who can concurrently access this share. 


This value must be greater than or equal to zero, or -1 (X'FFFFFFFF'), which means there is no 
limit to the number of users who can concurrently use this share. 
Error code 


1/0; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Optional Parameter Group 


CCSID used for text conversion 
INPUT; BINARY(4) 


The client CCSID that is used for text file data conversion. Text file data conversion is performed 
using this CCSID and the current CCSID of the system file. 


A value of 0 indicates that the user would like to use the currently configured CCSID for the server. 
See the Get Related Default CCSID (CDRGRDC) API for additional information on related 


CCSIDs. 


If the CCSID used for text conversion parameter is omitted, the API assumes a default value of 0. 


Enable text conversion 


INPUT; CHAR(1) 

Whether the server enables text conversion for this share. Possible values are: 
O Text conversion not enabled 
I Text conversion enabled 


2 Text conversion enabled and mixed data is allowed 


If the enable text conversion parameter is omitted, the API assumes a default value of 0. 


File extension table 
INPUT; CHAR(*) 


An array of table entries. There is no limit to the number of values specified. For the layout of a 
table entry, see Format of File Extension Table Entry. 


If the file extension table parameter is omitted, the API assumes that there are no file extensions for 
text conversion. If the file extension table parameter is specified, the number of table entries 
parameter must be specified also. 


Number of table entries 
INPUT; BINARY(4) 


The number of table entries. 


If the number of table entries parameter is left out, the API assumes a default value of 0. If the 
number of table entries parameter is specified, the file extension table parameter must be specified 
also. 


Format of File Extension Table Entry 


The following shows the format of a file extension table entry. For detailed descriptions of the fields in the 
table, see Field Descriptions. 


| Offset 
es Hex |Type Field 


| BINARY(4) Length of file extension 
| 4 4 CHAR(46) File extension 


Field Descriptions 


File extension. A file extension string that is null-terminated. Possible values include: 
* The server will convert all files. 
The server will convert all files without an extension. 


TXT, .TXT The server will convert all files ending with .TXT (that is, a. TXT, 
a.b.c. TXT). 


. TXT, ...TXT, Extensions with more than one leading period will have no effect on the 


server. No translation will be done. 


T*T The server will convert all files ending with an extension that substitutes any 
number of characters for the * wild card (that is, a.T123T, b. TXT, c.TEST). 
T?T The server will convert all files ending with an extension that substitutes any 


one character for the ? wild card (that is, a.T1T, b. TXT). 


Length of file extension. The size in bytes of the file extension. The length does not include the byte used 
for null-termination. 


Error Messages 


Message ID Error Message Text 

CPF3CIE E Required parameter &1 omitted. 

CPF3C36 E Number of parameters, &1, entered for this API was not valid. 
CPF3CF1 E Error code parameter not valid. 

CPF3CF2 E Error(s) occurred during running of &1 API. 

CPFA0D4 E File system error occurred. 

CPFB682 E API &1 failed with reason code &2. 

CPFB683 E Data conversion failed for API &1. 

CPFB684 E User does not have the correct authority for API &1. 
CPFB68A E Error occurred while working with shared resource &2. 
CPFB68B E Character is not valid for value &3. 

CPFB68D E Length specified in parameter &2 for API &1 not valid. 
CPIB685 E Error occurred on iSeries Support for Windows Network Neighborhood (iSeries 


NetServer) request. 


API Introduced: V4R2 


Top | Server Support APIs | APIs by category 


Add Print Server Share (QZLSADPS) API 


Required Parameter Group: 


Share name Char(12) 
Qualified output queue name Char(20) 
Text description Char(50) 
Spooled file type Binary(4) 
Print driver type Char(50) 
Error code Char(*) 


Optional Parameter Group 1: 


7 Qualified printer file Char(20) 


Optional Parameter Group 2: 


Publish print share Char(1) 


Default Public Authority: *USE 


Threadsafe: No 


The Add Print Server Share (QZLSADPS) API shares a system output queue with the network by using the 
iSeries Support for Windows Network Neighborhood server. 


Authorities and Locks 


To use this API, you must have *IOSYSCFG special authority or own the system output queue. 


Required Parameter Group 


Share name 
INPUT; CHAR(12) 


The name of the share to be added. 
Qualified output queue name 
INPUT; CHAR(20) 
The output queue. The first 10 characters contain the name of the output queue. The second 10 
characters contain the name of the library that contains the output queue. 


Text description 


INPUT; CHAR(50) 


The text description for this share. 
Spooled file type 
INPUT; BINARY(4) 


The type of spooled files that are created using this share. This is based on spooled file data 
expected to be sent by the client; no conversion will be done. 


Note: In most cases, the automatic type sense value is selected. The other options are needed for 
downward compatibility. Values can be: 


I User ASCH (*USERASCT) 

2 Advanced Function Printing (*AFP) 
3 SNA character string (*SCS) 
4 


Automatic type sensing 


Print driver type 
INPUT; CHAR(50) 
The text string that identifies the print driver that is appropriate for this share. When personal 
computers connect to this shared printer, this identifies the print driver that they should use. This 


text should match the name of a print driver known to the personal computer operating system. For 
example, 'IBM AFP 3820' is an Advanced Function Print driver type. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Optional Parameter Group 1 


Qualified printer file 
INPUT; CHAR(20) 
A template containing attributes used to create spooled files. The first 10 characters contain the 


name of the printer file. The second 10 characters contain the name of the library that contains the 
printer file. 


If the printer file parameter is left out, the API assumes that no printer file will be used to create 
spooled files. 


This parameter must be specified when optional parameter 2 is specified. Blanks can be specified 
for the printer file to indicate no printer file will be used to create spooled files. 


Optional Parameter Group 2 
Publish print share 
INPUT; CHAR(1) 
Whether to publish this print share. Possible values are: 
0 Do not publish the print share 
7 Publish the print share 


If the publish print share parameter is omitted, the API assumes a default value of 0. 


Error Messages 


Message ID Error Message Text 

CPF3CIE E Required parameter &1 omitted. 

CPF3CF1 E Error code parameter not valid. 

CPF3CF2 E Error(s) occurred during running of &1 API. 
CPFA0D4 E File system error occurred. 

CPFB682 E API &1 failed with reason code &2. 

CPFB683 E Data conversion failed for API &1. 

CPFB684 E User does not have the correct authority for API &1. 
CPFB68A E Error occurred while working with shared resource &2. 
CPFB68B E Character is not valid for value &3. 


CPIB685 E Error occurred on iSeries Support for Windows Network Neighborhood (iSeries 
NetServer) request. 


API Introduced: V4R2 


Top | Server Support APIs | APIs by category 


Change File Server Share (QZLSCHFS) API 


Required Parameter Group: 


Share name Char(12) 
Path name Char(*) 

Length of path name Binary(4) 
CCSID encoding of path name Binary(4) 
Text description Char(50) 
Permissions Binary(4) 
Maximum users Binary(4) 
Error code Char(*) 


1 
2, 
3 
4 
5 
6 
7 
8 


Optional Parameter Group: 


CCSID used for text conversion Binary(4) 
Enable text conversion Char(1) 
File extension table Char(*) 
Number of table entries Binary(4) 


Default Public Authority: *USE 


Threadsafe: No 


The Change File Server Share (QZLSCHFS) API changes the information about a shared portion of the 
integrated file system. 


Authorities and Locks 


To use this API, you must have *IOSYSCFG special authority or own the integrated file system directory. 


Required Parameter Group 


Share name 
INPUT; CHAR(12) 


The name of the share to be changed. 
Path name 
INPUT; CHAR(*) 
The path in the integrated file system to be shared with the network. A forward slash, '/', is required 
as the first character. 


Length of path name 


INPUT; BINARY(4) 


The length, in bytes, of the path name. The maximum length is 1024 bytes. 
CCSID encoding of path name 
INPUT; BINARY(4) 
The coded character set ID (CCSID) of the path name and the file extension table entries. 0 will 
result in the current job CCSID being used. 
Text description 
INPUT; CHAR(50) 


The text description for this share. 
Permissions 
INPUT; BINARY(4) 


The access available from the network for this share. Possible values follow. 
I Read only 


2 Read/Write 


Maximum users 
INPUT; BINARY(4) 


The maximum number of users who can concurrently access this share. 


This value must be greater than or equal to zero, or -1 (X'FFFFFFFF'), which means there is no 
limit to the number of users who can concurrently use this share. 
Error code 


1/0; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Optional Parameter Group 


CCSID used for text conversion 
INPUT; BINARY(4) 


The client CCSID that is used for text file data conversion. Text file data conversion is performed 
using this CCSID and the current CCSID of the system file. 


A value of 0 indicates that the user would like to use the currently configured CCSID for the server. 
See the Get Related Default CCSID (CDRGRDC) API for additional information on related 


CCSIDs. 


If the CCSID used for text conversion parameter is omitted, the API assumes that no change is 
requested and the current value remains unchanged. 


Enable text conversion 


INPUT; CHAR(1) 

Whether the server enables text conversion for this share. Possible values are: 
0 Text conversion not enabled 
I Text conversion enabled 


2 Text conversion enabled and mixed data is allowed 


If the enable text conversion parameter is omitted, the API assumes that no change is requested and 
the current value remains unchanged. 


File extension table 
INPUT; CHAR(*) 


An array of table entries. There is no limit to the number of values specified. For the layout of a 
table entry, see Format of File Extension Table Entry. 


If the file extension table parameter is omitted, the API assumes that no change is requested and 
current values remain unchanged. If the file extension table parameter is specified, the number of 
table entries parameter must be specified also. 


Number of table entries 
INPUT; BINARY(4) 


The number of table entries. 


If the number of table entries parameter is left out, the API assumes that no change is requested and 
the current value remains unchanged. If the number of table entries parameter is specified, the file 
extension table parameter must be specified also. 


Format of File Extension Table Entry 


The following table shows the format of a file extension table entry. For detailed descriptions of the fields 
in the table, see Field Descriptions. 


| Offset 
| Dec Hex /|Type Field 


| 0 0 BINARY(4) Length of file extension 
| 4 4 CHAR(46) File extension 


Field Descriptions 


File extension. A file extension string that is null-terminated. Possible values include: 
* The server will convert all files. 
The server will convert all files without an extension. 


TXT, .TXT The server will convert anything ending in .TXT (that is, a. TXT, a.b.c. TXT). 


T?T 


Extensions with more than one leading period will have no effect on the 
server. No translation will be done. 


The server will convert all files ending with an extension that substitutes any 
number of characters for the * wild card (that is, a.T123T, b. TXT, c. TEST). 


The server will convert all files ending with an extension that substitutes any 
one character for the ? wild card (that is, a.T1T, b. TXT). 


Length of file extension. The size in bytes of the file extension. The length does not include the byte used 
for null-termination. 


Error Messages 


Message ID 
CPF3C1EE 
CPF3C36 E 
CPF3CF1 E 
CPF3CF2 E 
CPFA0D4 E 
CPFB682 E 
CPFB683 E 
CPFB684 E 
CPFB68A E 
CPFB68B E 
CPFB68D E 
CPFB693 E 
CPIB685 E 


Error Message Text 

Required parameter &1 omitted. 

Number of parameters, &1, entered for this API was not valid. 
Error code parameter not valid. 

Error(s) occurred during running of &1 API. 

File system error occurred. 

API &1 failed with reason code &2. 

Data conversion failed for API &1. 

User does not have the correct authority for API &1. 
Error occurred while working with shared resource &2. 
Character is not valid for value &3. 

Length specified in parameter &2 for API &1 not valid. 
Data conversion failed for &5 API. 


Error occurred on iSeries Support for Windows Network Neighborhood (iSeries 
NetServer) request. 


API Introduced: V4R2 
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Change Print Server Share (QZLSCHPS) API 


Required Parameter Group: 


Share name Char(12) 
Qualified output queue name Char(20) 
Text description Char(50) 
Spooled file type Binary(4) 
Print driver type Char(50) 
Error code Char(*) 


Optional Parameter Group 1: 


7 Qualified printer file Char(20) 


Optional Parameter Group 2: 


Publish print share Char(1) 


Default Public Authority: *USE 


Threadsafe: No 


The Change Print Server Share (QZLSCHPS) API changes the information about a shared printer. 


Authorities and Locks 


To use this API, you must have *IOSYSCFG special authority or own the system output queue. 


Required Parameter Group 


Share name 
INPUT; CHAR(12) 


The name of the share to be changed. 
Qualified output queue name 
INPUT; CHAR(20) 
The name of the qualified output queue. The first 10 characters identify the name of the output 
queue. The second 10 characters contain the name of the library that contains the output queue. 
Text description 
INPUT; CHAR(50) 


The text description for this share. 
Spooled file type 
INPUT; BINARY(4) 


The type of spooled files that are created by using this share. This is based on spooled file data 
expected to be sent by the client; no conversion will be done. 


Note: In most cases, the automatic type sense value is selected. The other options are needed for 
downward compatibility. Values can be: 


ZI User ASCH (*USERASCI) 

2 Advanced Function Printing (*AFP) 
3 SNA character string (*SCS) 
4 


Automatic type sensing 


Print driver type 
INPUT; CHAR(50) 
The text string that identifies the print driver appropriate for this share. When personal computers 
connect to this shared printer, this identifies the print driver that they should use. This text should 


match the name of a print driver known to the personal computer operating system. For example, 
‘IBM AFP 3820' is an Advanced Function Print driver type. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Optional Parameter Group 1 

Qualified printer file 
INPUT; CHAR(20) 
A template containing attributes used to create spooled files. The first 10 characters contain the 
name of the printer file. The second 10 characters contain the name of the library that contains the 
printer file. If the printer file parameter is omitted, the API assumes that no change is requested and 


the current value remains unchanged. 


This parameter must be specified when optional parameter 2 is specified. 


Optional Parameter Group 2 


Publish print share 
INPUT; CHAR(1) 


Whether to publish this print share. Possible values are: 


0 Do not publish the print share 


I Publish the print share 


If the publish print share parameter is omitted, the API assumes no change is requested and the 
current value remains unchanged. 


Error Messages 


Message ID 
CPF3C1IEE 
CPF3CF1 E 
CPF3CF2 E 
CPFA0D4 E 
CPFB682 E 
CPFB683 E 
CPFB684 E 
CPFB68A E 
CPFB68B E 
CPFB693 E 
CPIB685 E 


Error Message Text 

Required parameter &1 omitted. 

Error code parameter not valid. 

Error(s) occurred during running of &1 API. 

File system error occurred. 

API &1 failed with reason code &2. 

Data conversion failed for API &1. 

User does not have the correct authority for API &1. 
Error occurred while working with shared resource &2. 
Character is not valid for value &3. 

Data conversion failed for &5 API. 


Error occurred on iSeries Support for Windows Network Neighborhood (iSeries 
NetServer) request. 


API Introduced: V4R2 
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Change Server Guest (QZLSCHSG) API 


Required Parameter Group: 


1 Guest user profile Input Char(10) 
2 Error code VO Char(*) 


Default Public Authority: *USE 


Threadsafe: No 


The Change Server Guest (QZLSCHSG) API changes the user profile used by the iSeries Support for 
Windows Network Neighborhood server when an unknown user requests access to shared resources on the 
system. The changes made with this API do not take effect until the server is restarted. 


A user profile with any special authority cannot be specified as the guest profile. 


Authorities and Locks 


To use this API, you must have both *IOS YSCFG and *SECADM special authorities. 
Guest user profile 
*USE 


Required Parameter Group 
Guest user profile 
INPUT; CHAR(10) 


The user profile for the iSeries Support for Windows Network Neighborhood server access by 
unknown users. If this field is blank, unknown users will not have access to resources on the 
system. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Error Messages 


Message ID Error Message Text 


CPF3CF1 E Error code parameter not valid. 


CPF3CF2 E 
CPFA0D4 E 
CPFB682 E 
CPFB683 E 
CPFB684 E 
CPFB686 E 


CPFB687 E 
CPFB68C E 
CPIB685 E 


Error(s) occurred during running of &1 API. 

File system error occurred. 

API &1 failed with reason code &2. 

Data conversion failed for API &1. 

User does not have the correct authority for API &1. 


Error configuring iSeries Support for Windows Network Neighborhood (iSeries 
NetServer). 


Cannot find the guest user profile &3. 
Requested guest user profile &2 has incorrect authority. 


Error occurred on iSeries Support for Windows Network Neighborhood (iSeries 
NetServer) request. 


API Introduced: V4R2 
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Change Server Information (QZLSCHSI) API 


Required Parameter Group: 


Request variable Char(*) 
Length of request variable Binary(4) 
Format Char(8) 
Error Code Char(*) 


Default Public Authority: *USE 


Threadsafe: No 


The Change Server Information (QZLSCHSJ) API changes general configuration information for the 
iSeries Support for Windows Network Neighborhood server. Changes made with this API using format 
ZLSS0200 take effect immediately. All other changes made with this API using format ZLSSO100 do not 
take effect until the server is restarted. 


Authorities and Locks 


To use this API, you must have *IOSYSCFG special authority. To use format ZLSS0200 to enable an 
iSeries NetServer user, you must have *SECADM special authority and *OBJMGT and *USE authority to 
the system user profile. 


Required Parameter Group 


Request variable 
INPUT; CHAR(*) 


A variable that is used to pass values for the information to be changed. 


For more information, see Format of Information Changed. 


Length of request variable 
INPUT; BINARY(4) 


The length of the variable that is used to pass information to be changed. For Format ZLSS0100, if 
this length is less than the total length of the format, the fields not completely included by the 
length use their default values. For Format ZLSS0200, if this length does not include all of the user 
names to be enabled, only the user names completely included by the length are enabled. 


Format 
INPUT; CHAR(8) 


The content and format of the information to be changed by the simplified server. The following 
format names must be used: 


ZLSSO100 Server information 


ZLSSO200_ Enable user information 


For more information, see Format of Information Changed. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Format of Information Changed 


The following table shows how the content of the request variable is organized. For descriptions of each 
field, see Field Descriptions. 


| Offset 
_ c | Hex |Type Field 


F0 —[0 — [BINARY — [ees 
[ 46 | 2E |CHAR@24) |ScopeID -~SCS 
[270 | 108 |CHARG)  |WINSpoxy ~~~~SCS~*~S 
[271 | 10F |CHARG) [Reserved ~~~~~SOSOSCSCS~*~S 


Format ZLSS0200 


| Offset 
| Dec | Hex |Type Field 


| 0 | 0 [BIN ARY(4) [N umber of iSeries NetServer users to enable 


This field repeats |CHAR(0) iSeries NetServer user name 
for each user. 


Field Descriptions 


Authentication method. The authentication method used to authenticate users. Valid values are: 
character 0 (X'FO') The server authenticates with encrypted passwords 


character 1 (X'F1') The server authenticates with Kerberos v5 tokens 


The default value for this field is character 0. 


Note: Authentication method should only be set to character 1 in networks containing only Windows 2000 
and Windows XP iSeries NetServer clients that are configured to participate in a Kerberos realm. All other 
Windows clients will be unable to connect to iSeries NetServer when Kerberos support is enabled.“ 


Browsing interval. The amount of time, in seconds, between each server announcement that is used for 
browsing. The maximum allowable value is 720000 milliseconds (or twelve minutes). The minimum 
allowable value is zero, which means there will be no server announcements. 

The default value for this field is 720000 milliseconds. 

CCSID. The coded character set ID (CCSID) that is used for all clients connected to the server. 


The default value for this field is the associated ASCII CCSID for the CCSID of the job used to start the 
server. See the Get Related Default CCSID (CDRGRDC) API for additional information on related 


CCSIDs. 

Note: A value of 0 indicates that the user would like to use the associated ASCII CCSID for the CCSID of 
the job used to start the server. The field in the corresponding header file for this format may indicate code 
page, but the value to be entered as input must be a CCSID. 

Idle time-out. The amount of time, in seconds, that a connection to the simplified server will remain active 
once activity has ceased on that connection. The idle time-out value must be greater than zero, or -1 
(X'FFFFFFFF') for no autodisconnect. 

The default value for this field is 6000 seconds. 

iSeries NetServer user name. The iSeries NetServer user name to be enabled. 


Number of iSeries NetServer users to enable. The number of iSeries user names in the list to be enabled. 


Opportunistic lock time-out. The amount of time that an opportunistic lock is left enforced for a resource. 
The opportunistic lock value must be greater than zero. 


The default value for this field is 600. 
Note: Currently, this function is not supported. 


Scope ID. A string that names the network scope to be used by the Windows Internet Name Service 
(WINS) server. 


The default value is nothing. 
Server role The logon server role for the system. Valid values are: 
0 The system is not a server 


I The system is a server 


The default value for this field is 0. 
WINS primary address. The IP address of the primary Windows Internet Name Service (WINS) server. 
If this field is empty, it indicates no WINS primary server. This is the default. 


WINS proxy. Enable or disable the system to act as a WINS proxy. This enables non- WINS clients to 
obtain name resolution from WINS. WINS is a dynamic naming service that resolves NetBIOS computer 


names to IP addresses. Valid values are: 


character 0 (X'F0') Disable WINS proxy 


character 1 (X'FI') Enable WINS proxy 


The default value for this field is character 0. 


WINS secondary address. The IP address of the secondary Windows Internet Name Service (WINS) 


server. 


If this field is empty, it indicates no WINS secondary server. This is the default. 


Error Messages 


Message ID Error Message Text 

CPF3CIE E Required parameter &1 omitted. 

CPF3CF1 E Error code parameter not valid. 

CPF3CF2 E Error(s) occurred during running of &1 API. 

CPFA0D4 E File system error occurred. 

CPFB682 E API &1 failed with reason code &2. 

CPFB683 E Data conversion failed for API &1. 

CPFB684 E User does not have the correct authority for API &1. 

CPFB686 E Error configuring iSeries Support for Windows Network Neighborhood (iSeries 
NetServer). 

CPFB690 E Error changing iSeries Support for Windows Network Neighborhood (iSeries 
NetServer) information. 

CPFB694 E When enabling users, &1 users were not enabled. 

CPIB685 E Error occurred on iSeries Support for Windows Network Neighborhood (iSeries 


NetServer) request. 


API Introduced: V4R2 


Top | Server Support APIs | APIs by category 


Change Server Name (QZLSCHSN) API 


Required Parameter Group: 


Server name Char(15) 
Domain name Char(15) 
Text description Char(50) 
Error code Char(*) 


Optional Parameter: 


5 Allow system name Char(1) 


Default Public Authority: *USE 


Threadsafe: No 


The Change Server Name (QZLSCHSN) API changes the name by which the iSeries Support for Windows 
Network Neighborhood server is known on the network. The changes made with this API do not take effect 
until the server is restarted. 


Authorities and Locks 


To use this API, you must have *IOSYSCFG special authority. 


Required Parameter Group 


Server name 
INPUT; CHAR(15) 


The name by which the system is known in the Windows Network Neighborhood. 
Domain name 
INPUT; CHAR(15) 


The domain name (or workgroup) in which the server appears. 
Text description 
INPUT; CHAR(50) 


The description of the system that appears on the network. 
Error code 
1/0; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 


Parameter. 


Optional Parameter 


Allow system name 
INPUT; CHAR(1) 


Whether the server allows clients to connect using the system name found in the iSeries network 


attributes. Possible values are: 


0 Do not allow access to the server using the TCP/IP system name. 


I Allow access to the server using the TCP/IP system name. 


If the allow system name parameter is omitted, the API assumes that no change is requested and the 


current value remains unchanged. 


Error Messages 


Message ID 
CPF3C1IEE 
CPF3C3A E 
CPF3CF1 E 
CPF3CF2 E 
CPFA0D4 E 
CPFB682 E 
CPFB683 E 
CPFB684 E 
CPFB686 E 


CPFB68B E 
CPIB685 E 


Error Message Text 

Required parameter &1 omitted. 

Value for parameter &2 for API &1 not valid. 

Error code parameter not valid. 

Error(s) occurred during running of &1 API. 

File system error occurred. 

API &1 failed with reason code &2. 

Data conversion failed for API &1. 

User does not have the correct authority for API &1. 


Error configuring iSeries Support for Windows Network Neighborhood (iSeries 
NetServer). 


Character is not valid for value &3. 


Error occurred on iSeries Support for Windows Network Neighborhood (iSeries 
NetServer) request. 


API Introduced: V4R2 


Top | Server Support APIs | APIs by category 


End Server (QZLSENDS) API 


Required Parameter: 


1 Error code 


Default Public Authority: *USE 


Threadsafe: No 


The End Server (QZLSENDS) API ends the jobs that support the iSeries Support for Windows Network 
Neighborhood server. This API does not end the QSERVER subsystem in which the jobs run. 


Authorities and Locks 


To use this API, you must have *IOSYSCFG special authority. 


Required Parameter 
Error code 
1/0; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Error Messages 


Message ID Error Message Text 

CPF3CF1 E Error code parameter not valid. 

CPF3CF2 E Error(s) occurred during running of &1 API. 
CPFB682 E API &1 failed with reason code &2. 

CPFB684 E User does not have the correct authority for API &1. 


CPFB689 E Unable to end iSeries Support for Windows Network Neighborhood (iSeries 
NetServer). 


API Introduced: V4R2 


Top | Server Support APIs | APIs by category 


End Server Session (QZLSENSS) API 


Required Parameter Group: 


1 Workstation name Char(15) 
2 Error code Char(*) 


Optional Parameter: 


3. Session identifier Binary(8) 


Default Public Authority: *USE 


Threadsafe: No 


The End Server Session (QZLSENSS) API ends a single session or all the sessions that were established 
from the specified workstation. 


Authorities and Locks 


To use this API, you must have *IOSYSCFG special authority. 


Required Parameter Group 


Workstation name 
INPUT; CHAR(15) 
The name of the workstation from which the session to the server was established. When specifying 


the session identifier parameter to end a single session, *SESSID must be specified for the 
workstation name. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Optional Parameter 


Session identifier 
INPUT; BINARY(8) 


Allows the caller to end a single session. This parameter must be 0 if any value other than 


*SESSID is specified for the workstation name. Allowable values are: 


0 


All sessions for the specified workstation name are ended. 


Session identifier The identified session is ended. 


If the session identifier parameter is not specified, the API assumes a value of 0. 


Error Messages 


Message ID 
CPF3C1IEE 
CPF3CF1 E 
CPF3CF2 E 
CPFB682 E 
CPFB683 E 
CPFB684 E 
CPFB68E E 


Error Message Text 

Required parameter &1 omitted. 

Error code parameter not valid. 

Error(s) occurred during running of &1 API. 

API &1 failed with reason code &2. 

Data conversion failed for API &1. 

User does not have the correct authority for API &1. 


Error ending iSeries Support for Windows Network Neighborhood (iSeries NetServer) 
session. 


API Introduced: V4R2 


Top | Server Support APIs | APIs by category 


List Server Information (QZLSLSTI) API 


Required Parameter Group: 


Qualified user space name Char(20) 
Format Char(8) 
Information qualifier Char(15) 
Error code Char(*) 


Optional Parameter 1: 
5 Session user Char(10) 
Optional Parameter 2: 


6 Session identifier Binary(8) 


Default Public Authority: *USE 


Threadsafe: No 


The List Server Information (QZLSLSTI) API lists information about the server for shares, configuration, 
sessions, Statistics, and connections. You may use the information qualifier function to list just the 
information in which you are interested. 


Authorities and Locks 


To use the *RESET qualifier for the ZLSLO400 format, you must have *IOSYSCFG special authority. 
User Space Authority 
*CHANGE 
User Space Library Authority 
*USE 
User Space Lock 
*EXCLRD 


Required Parameter Group 


Qualified user space name 
INPUT; CHAR(20) 


The user space that is to receive the server information. The first 10 characters contain the user 
space name, and the second 10 characters contain the name of the library where the user space is 
located. 


Format 
INPUT; CHAR(8) 


The content and format of the information to be returned about the iSeries Support for Windows 
Network Neighborhood server. Possible format names follow: 


ZLSLO100 Share information 

ZLSLO1O1 Same as ZLSLO100, plus extension information 
ZLSLO200 Configuration information 

ZLSLO201 Same as ZLSLO200, plus allow system name 
ZLSLO300 Session information 

ZLSLO400_ Statistical information 

ZLSLO600 Session connection information 

ZLSLO700 Share connection information 

ZLSLO800 Share type information 

ZLSLO900_ Disabled user profiles 


For more information, see Format of Information List. 


Information qualifier 
INPUT; CHAR(15) 


A restriction on the information to be retrieved. This parameter allows the caller to request a subset 
of the entries that would normally be returned on a given format. Currently, this parameter applies 
only to the ZLSLO100 and ZLSLO101 (share information), ZLSLO300 (session information), 
ZLSL0400 (statistical information), ZLSL0600 (session connection information), ZLSLO700 (share 
connection information), and ZLSL0800 (share type information) formats. 


For formats ZLSLO200 and ZLSLO201, this parameter is ignored. 

For format ZLSLO300, a valid session name, *SESSID, or *ALL is allowed. 
For format ZLSL0400, only the *ALL and *RESET qualifiers are valid. 

For format ZLSL0600, a valid session name or *SESSID is required. 

For format ZLSLO700, a valid share name is required. 

For format ZLSL0800, only the *ALL qualifier is valid. 

For format ZLSLO0900 this parameter must be all blanks. 


If this parameter is all blanks or is *ALL, no information qualification is performed. Allowable 
values include: 


Information name Information about the specified list entry only. 
Generic information name All information matching the generic string of the specified format. 
*ALL All information of the specified format. 


*RESET Statistical information is reset to zero. The information qualifier is 
valid for the ZLSLO400 format only. When the *RESET qualifier is 
specified, the values will be reset to zero before they are listed. 


*SESSID The information returned is for the session indicated by the session 
identifier parameter. When this value is specified for this parameter, 
*SESSID must be specified for the session user parameter. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Optional Parameter 1 
Session user 
INPUT; CHAR(10) 


Allows the caller to restrict the session information to be retrieved. This parameter is ignored if a 
generic information name, or *ALL, is specified on the information qualifier parameter. Currently, 
this parameter applies only to the ZLSLO0300 (session information) and ZLSL0600 (session 
connection information) formats. Allowable values include: 


*ALL The information returned is for all users of a specific session. 


*SESSID The information returned is for the session indicated by the session 
identifier parameter. When this value is specified for this parameter, 
*SESSID must be specified for the information qualifier parameter. 


Session user name Information about the specified user only. 


If the session user parameter is omitted, the API assumes a value of *ALL. 


Optional Parameter 2 

Session identifier 
INPUT; BINARY(8) 
Allows the caller to restrict the session information to be retrieved to a single session. This 
parameter must be 0 if any value other than *SESSID is specified on the information qualifier and 
session user parameters. Currently, this parameter applies only to the ZLSL0300 (session 
information) and ZLSLO600 (session connection information) formats. Allowable value are: 


0 All information of the specified format 


Session identifier Information returned is for the specified session only 


If the session identifier parameter is not specified, the API assumes a value of 0. 


Format of Information List 


The field list consists of: 

e A user area 

e A generic header section 

e An input parameter section 

e A data section 

o ZLSLO100 

ZLSLO101 
ZLSLO200 
ZLSLO0201 
ZLSLO300 
ZLSLO400 
ZLSL0600 
ZLSLO700 
ZLSL0800 
ZLSLO900 


OO 000 0 0 0 0 


For information about the user area and generic header, see User Space Format for List APIs. 


There are ten possible formats for the data section. The layout of the contents of the user space is 
determined by the format used. The following tables show how the contents of the input parameter section 
and the data format sections are organized. For descriptions of each field, see Field Descriptions. 


When you retrieve list entry information from a user space, you must use the entry size returned in the 
generic header as a displacement to the next list entry for formats ZLSLO200, ZLSL0201, ZLSLO300, 
ZLSL0400, ZLSL0600, ZLSLO700, ZLSLO800, and ZLSLO0900. For formats ZLSLO100 and ZLSLO101, 
use the length of this entry field at the start of each entry to calculate the displacement to the next list entry. 
The size of each entry may be padded at the end. If you do not use the entry size, the result may not be 
valid. 


Input Parameter Section 


| Offset 
a Hex |Type Field 


ZLSLO100 Format 


| Offset 
| Dec | Hex |Type Field 


[| 0 | 0 |BINARY()  [Lengthofthisentry = = + 2 
[ 4 | 4 |CHAR(2)  |Shaename = — ss—<C—s—sCS 
[ 16 [{ 10 |BINARY(4) [Devicetype = = = = ss—s—SS 
[ 20 [ 14 |BINARY() [Permissions = = = 
| 24 [ 18 |BINARY(4) [Maximumusers 9 
[ 28 [ 1C |BINARY(4) |[Currentusers 
[ 32 | 20 |BINARY(4) [Spooledfiletype =i (asti‘“‘;:~S™S 
[ 36 | 24 |BINARY(4)  |Offsettopathname = =———— 
| 40 [ 28 |BINARY(4)  |Lengthofpathname = = = = 
[ 44 | 2C |CHAR(20) ~ |Qualifiedoutputqueue  ———s 
[ 64 | 40 |CHAR(SO) ~ |Printdrivertype = ss 
[ 114 | 72 |CHAR(50) ~~ |Textdescription = —ss—SsCS 
[ 164 [ A4 |CHAR(*) — [Pathname 


ZLSLO101 Format 


| Offset 
| Dec | Hex |Type Field 


[| 0 [| 0 |BINARY(@)  |Lengthofthisentry = = = = 
[4 [4 |GHARG2|Sharename——~—~—~SCS~S~S 
| 20 [ 14 |BINARY(@) [Permissions = = 
| 28 [ IC |BINARY(4) |Currentusers 9 9 8 
| 32 [| 20 |BINARY()  |Spooledfiletype = == ss 
Ce Oe 
| 28 |BINARY(4)  Lengthofpathname = 
ae ena — sia pa gee 
i) EHR) eee 
[ tet | Ad |CHAR@O)  |Qualifiedprinterfile ~~ ~SOSOSCS~*S 
| 184 [ B8 |BINARY(4) — [CCSID used for text conversion 
| 192 [ CO |BINARY(4) [Number oftableentries == 
| 196 | C4 |CHAR() {Enable text conversion 
| 197 [| CS |CHAR() — [Publishprintshare = 


| * | * [CHAR(*) [Path name 


poe ie of file extension 
femsoe i extension 


file extension 
table entry. 


ZLSLO200 Format 


| Offset 
| Dec | Hex |Type Field 


[0 | 0 |BINARY@ |ccsID 
[| 8 [| 8 J|BINARY(4) [Idletime-out;©£8 
| 12 [ C  |BINARY()  [Pendingidletime-outt) = 
[ 16 [ 10 |BINARY(4) [Opportunistic lock time-out = 
| 20 [| 14 |BINARY(4) [Pending opportunistic lock time-out 
| 24 [| 18 |BINARY(4) |Browsinginterval = = = 
2 BO Oe 
3a] SI NARS [Peaiine WINS ST 
[ 40 [| 28 |BINARY(4) — Guest support 

| 44 [| 2C J|BINARY(4) [Pending guestsuppot == 
| 58 [ 3A |CHAR(IO) [Pending guestuser profile = 
| 68 [| 44 |CHAR(S) Servername = = ——— 
| 83 [| 53 |CHAR(S) — |Pendingservername = 
| 113 [ 71 |CHAR(S) — |Pendingdomainname = 
| 128 [| 80 |CHAR(S0) ~ [Textdescription = 
| 243 | F3 |CHAR(IS) [Pending WINS primary address 
[258 | 102 |CHARGS)  |WINS secondary address —~=~C~S~S~S~*S 
[| 273 | 111 |CHAR(IS) [Pending WINS secondary address 
[| 288 | 120 |CHAR(224) |[ScopeID 9 


ZLSLO201 Format 


| Offset 
| Dec | Hex /Type Field 


[| 4 [| 4  |BINARY() [PendingCCSID 
; 8 | 8 J|BINARY() [idletime-outt; ££ 
[ 12 | C  |BINARY(4)  [Pendingidletime-out = 
| 16 [ 10 |BINARY(4)  [Opportunisticlocktime-out = 
| 20 | 14 |BINARY(4) [Pending opportunistic lock time-out = 
| 24 | 18 |BINARY(4)  [Browsinginterval = = = = 
| 28 [| IC |BINARY(4)  [Pendingbrowsinginterval = 
| 32 [| 20 |BINARY(4) [WINSenablement = = = == 
| 36 | 24 |BINARY(4) [Pending WINSenablement = 
[| 40 [ 28 |BINARY(4) |Guestsuppot = 
| 44 | 2C |BINARY(4) [Pending guest support. = 
| 48 | 30 |CHAR(O0) |Guestuserprofile = 
| 58 [| 3A |CHAR(IO) [Pending guestuser profile = 
| 68 | 44 CHARMS) |Servername 
| 83 | 53 |CHAR(5)  [Pendingservername = 
| 98 [ 62 |CHAR(S) [Domainname = = = =  — 
| 113 [ 71 |CHARCS5) ~— [Pendingdomainname = 
| 128 | 80 |CHAR(0)  |Textdescription = 
| 178 [| B2 |CHAR(S0) — [Pendingtextdescription = 
| 228 | E4 [CHAR(5) — [WINS primaryaddress 
| 243 | F3 |CHAR(I5) [Pending WINS primary address 
[| 258 [ 102 |CHAR(IS) — [WINSsecondaryaddress = 
| 273 | 111 [CHARC5) [Pending WINS secondary address 
| 288 [| 120 |CHAR(224) [ScopeID 
[| 512 | 200 |CHAR(224)  |PendingscopeID = ==——s—s—S 
| 736 | 2EO [CHAR() ~— [Allowsystemname = = 
| 737 | 2E1 |CHAR() — [Pendingallowsystemname = 
E; 738 | 2E2 [CHAR() [Authentication method *& 

| & 739 | 2E3 |CHAR() [Pending authentication method * 

| 740 | 2E4 |BINARY(4) |Serverrole = = = ss—‘—sSS 
| 744 | 2E8 |BINARY(4) |Pendingserverrole = = = = 


ZLSLO300 Format 


| Offset 
| Dec Hex /|Type Field 


| 48 | 30 |CHAR(I) = [Logontype 


ZLSL0400 Format 


| Offset 
ape c || Hex Type Field 


[28 [IC |BINARYG) [Password violations ——~—~SC~S~S~S*S 
[_4¢_[-2C_[BINARYG) [Number of bytes sent (high) ——~—S™S 
[_48__[ 30 |BINARYG) [Number of bytes received Gow) SCS 


ZLSLO600 Format 


[Offset 

| Dec | Hex |Type Field 

[ 0 | 0 JBINARY()  |ConnectionID = = = —<C—sCS 
[ 4 | 4 |BINARY(4) |Connectiontype = ass—(‘“—s—S™S 
[ 8 | 8 |BINARY(4) |Numberoffilesopen == —— 
[ 12 | C  [BINARY(4) [Number ofconnectionusers 
[ 16 | 10 |BINARY(4) |Connectiontime = =——s—i‘“—S™S™~™ 
[| 20 [ 14 |CHAR(O) ~~ [Username 88 
[ 30 | IE |CHAR(@2) |Shaename = = —(isti‘—Ss~™~™~C~S™S 
[| 42 [ 2A |CHAR(@) ~~ [Reserved = —— 
[ 48 | 30 |BINARY(8) |Sessionidentifier = 
[ 56 | 38 |CHAR(8) [Reserved = (si—‘“‘“—s~—“‘“‘:;”W 


ZLSLO700 Format 


[Offset 

| Dec | Hex |Type Field 

[ 0 | 0 [BINARY(4) |ConnectionID = = —S 
[ 4 | 4 [BINARY(4) |Connectiontype = = = —i‘—S 
[ 8 | 8 |BINARY(4) |Numberoffilesopen == —~S 
[ 12 | C  |[BINARY(4) [Number of connectionusers 
[ 16 | 10 |BINARY(4) |Connectiontime = —CS~—S 
| 20 [ 14 |CHAR(O) [Username 9 8 
[ 30 | 1B |CHAR(5) = [Workstationname = CS 
[ 45 | 2D |CHARG) [Reserved = = ass—<‘—i—sSS 
[ 48 | 30 |BINARY(8) |Sessionidentifier = ss—S 
[ 56 | 38 |CHAR(8) [Reserved = s—‘—s 


ZLSLO800 Format 


| Offset 
| Dec | Hex /|Type Field 


| 0 0 [CHAR(12) [Share name 
| 12 | C [BINARY (4) [Device type 


ZLSLO900 Format 


| Offset 

| Dec | Hex Type Field 

This field repeats for |CHAR(10) iSeries Netserver user name 
each user. 


Field Descriptions 


Allow system name. Whether the server allows clients to connect using the system name found in the 
iSeries network attributes. Possible values are: 


0 Do not allow access to the server using the system name. 


I Allow access to the server using the system name. 


Authentication method. The method used to authenticate users. Possible values are: 
character 0 The server authenticates with encrypted passwords. 


character 1 The server authenticates with Kerberos v5 tokens.*& 


Average response time. The average server response time in milliseconds. 
Browsing interval. The amount of time, in milliseconds, between each browsing server announcement. 
CCSID. The coded character set ID (CCSID) that is used by all clients connected to the server. 


Note: The field in the corresponding header file for this format may indicate code page, but the value 
returned will be the CCSID. 


CCSID used for text conversion. The CCSID that is used for text file data conversion. 


Note: The field in the corresponding header file for this format may indicate code page, but the value 
returned will be the CCSID. 


Connection ID. The number that identifies the connection. 
Connection time. The number of seconds since the connection was established. 


Connection type. The type of the connection made from the workstation to the shared resource. Possible 
values are: 


0 Disk drive 


ZI Spooled output queue 


Current users. The number of connections that are currently made to the resource. A value of -1 
(X'FFFFFFFF') means that the server was unable to retrieve the actual value. 


Date and time reset. The date and time when the server statistics were reset. 
The 13 characters are: 
vi Century, where 0 indicates years 19xx and 1 indicates years 20xx. 
2-7 Date, in YYMMDD (year, month, and day) format. 


S&-13 Time of day, in HHMMSS (hours, minutes, and seconds) format. 


Date and time started. The date and time when the server was started. The 13 characters are: 
I Century, where 0 indicates years 19xx and 1 indicates years 20xx. 
2-7 Date, in YYMMDD (year, month, and day) format. 


S-13 Time of day, in HHMMSS (hours, minutes, and seconds) format. 


Device type. One of the following values: 
0 Disk drive 


ZI Spooled output queue 


Domain name. The name of the domain in which the iSeries Support for Windows Network Neighborhood 
server is a member. 


Enable text conversion. Whether the server enables text conversion for this share. Possible values are: 
O Text conversion not enabled 
1 Text conversion enabled 


2 Text conversion enabled and mixed data is allowed 


Encrypted password. Whether the the encrypted password was used to establish the session to the server. 
Possible values are: 


O Anencrypted password was not used to establish the session 


I Anencrypted password was used to establish the session 


File extension. A file extension string that is null-terminated. Possible values include: 
* The server will convert all files. 
The server will convert all files without an extension. 
TXT, .TXT The server will convert all files ending with .TXT (that is, a. TXT, a.b.c. TXT). 


a. Maree B. @ opeere TXT Extensions with more than one leading period will have no effect on the server. 
No translation will be done. 


T*T The server will convert all files ending with an extension that substitutes any 
number of characters for the * wild card (that is, a.T123T, b. TXT, c. TEST). 


T?T The server will convert all files ending with an extension that substitutes any 
one character for the ? wild card (that is, a.T1T, b. TXT). 


File opens. The number of file opens for the whole server. 

Format specified. The content and format of the information to be returned about the iSeries Support for 

Windows Network Neighborhood server. Possible format names follow: 
e ZLSLO100 

ZLSLO101 

ZLSLO200 

ZLSLO201 

ZLSLO0300 

ZLSLO400 

ZLSL0600 

ZLSLO700 

ZLSLO800 

ZLSLO0900 


Guest support. A guest user profile may be used in the event an unknown user attempts to access resources 
on the system. Possible values are as follows: 


O Use of guest user profile not supported 


I Use of guest user profile supported 


Guest user profile. The user profile to be used in the event an unknown user attempts to access resources 
on the system. 


Idle time-out. The amount of time, in seconds, a connection to the simplified server remains active once 
activity has ceased on that connection. 


Information qualifier specified. A restriction on the information to be retrieved. If a qualifier is specified 
that is inconsistent with the format requested, an error message is returned. A null list is returned if no 
information meets the qualifications. If this parameter is all blanks, no information qualification is 
performed. Allowable values include: 


Information name Information about this specified format only 
Generic information name All information that matches the generic string of the specified format 
*ALL All information 


*RESET Statistical information is reset to zero. The information qualifier is valid for 
the ZLSL0400 format only. 


iSeries NetServer user name. The name of an iSeries NetServer user. 


Length of file extension. The size in bytes of the file extension. The length does not include the byte used 
for null-termination. 


Length of path name. The length of the local path name of the shared resource in bytes. 


Length of this entry. The total length of the list entry in bytes. 
Logon type. The type of authentication used to connect to the server. Possible values for the flag follow: 
O Authentication using the defined guest user profile 


J Regular user authentication 


Maximum users. The maximum number of concurrent connections that the shared resource can 
accommodate. This number is unlimited if the value is -1. 


Number of bytes received (high). The number of server bytes received from the network (high-order bits 
of 8-byte combinations of both number of bytes received fields). 


Number of bytes received (low). The number of server bytes received from the network (low-order bits of 
8-byte combinations of both number of bytes received fields). 


Number of bytes sent (high). The number of server bytes sent to the network (high-order bits of 8-byte 
combinations of both number of bytes sent fields). 


Number of bytes sent (low). The number of server bytes sent to the network (low-order bits of 8-byte 
combinations of both number of bytes sent fields). 


Number of connections. The number of connections made during the session. 
Number of connection users. The number of users on the connection. 
Number of files open. The number of files that are open currently. 


Number of sessions. The number of sessions that are established between the server and the requester. 


Number of table entries. The number of file extension entries in the file extension table. 
Offset to extension table. The offset from the start of user space where the file extension table starts. 


Offset to path name. The offset from the start of user space where the path name of the shared resource 
starts. 


Opportunistic lock (oplock) time-out. The amount of time, in seconds, an opportunistic lock is left 
enforced for a resource. Currently, this function is not supported. 


Password violations. The number of server password violations. 


Path name. A path in the integrated file system. The path name is stored internally in unicode format; 
when listed, it is converted into the CCSID of the current job. 


Pending allow system name. Whether the server allows clients to connect using the system name found in 
the network attributes the next time the server is started. Possible values are: 


0 Do not allow access to the server using the system name 


I Allow access to the server using the system name. 


Pending authentication method. The method that will be used to authenticate users the next time the 
server is started. Possible values are: 


character 0 The server will authenticate with encrypted passwords. 


character 1 The server will authenticate with Kerberos v5 tokens.*& 


Pending browsing interval. The amount of time, in seconds, to be used the next time the server is started, 
between each browsing server announcement. 


Pending CCSID. The CCSID that is used by all clients connected to the server the next time the server is 
started. 


Note: The field in the corresponding header file for this format may indicate code page, but the value 
returned will be the CCSID. 


Pending domain name. The name of the domain in which the server will be a member the next time the 
server is started. 


Pending guest support. A guest user profile may be used the next time the server is started in the event an 
unknown user attempts to access resources on the system. Possible values are: 


0 Use of guest user profile not supported 


I Use of guest user profile supported 


Pending guest user profile. The user profile to be used the next the time the server is started in the event 
that an unknown user attempts to access resources on the system. 


Pending idle time-out. The amount of time (in seconds) to be used the next time the server is started so 
that a connection to the server will remain active once activity has ceased on that connection. 


Pending opportunistic lock time-out. The amount of time an opportunistic lock (oplock) is left enforced 
for a resource to be used the next time the server is started. Currently, this function is not supported. 


Pending scope ID. A string that names the network scope to be used by the Windows Internet Name 
Service (WINS) server the next time the server is started. 


Pending server name. The name the server will be known as on the system the next time the server is 
started. 


Pending server role. The value that determines the logon server role for this system the next time the 
server is started. Possible values are: 


0 System will not be a server. 


ZI System will be a server. 


Pending text description. An optional comment about the shared resource to be used the next time the 
server is started. 


Pending WINS enablement. Whether this system uses the services of a Windows Internet Name Service 
(WINS) server the next time the server is started. Possible values are: 


0 Donot use WINS server 


Il Use WINS server 


Pending WINS primary address. The IP address of the primary Windows Internet Name Service (WINS) 
server to be used the next time the server is started. 


Pending WINS secondary address. The IP address of the secondary Windows Internet Name Service 
(WINS) server to be used the next time the server is started. 


Permissions. Permissions to be applied against the disk for sharing. Possible values are: 
I Read only 


2 Read/write 


Print driver type. The text string that identifies the print driver appropriate for this share. When personal 
computers connect to this shared printer, this identifies the print driver they should use. This text should 
match the name of a print driver known to the personal computer operating system. 

Print jobs queued. The number of server print jobs spooled. 

Publish print share. Whether the print share is to be published. Possible values are: 


0 Print share is not published 


I Print share is published 


Qualified output queue. The name and library of the output queue. The first 10 characters identify the 
name of the output queue. The second 10 characters contain the library that contains the output queue. 


Qualified printer file. The name and library of the printer file. The first 10 characters identify the name of 
the printer file. The second 10 characters contain the library that contains the printer file. 


Reserved. Field not used currently. 


Scope ID. A string that names the network scope to be used by the Windows Internet Name Service 
(WINS) server. 


Server name. The name by which the server is known on the system. 
Server role. The value that determines the logon server role for this system. Possible values are: 
O System is not a server. 


I System is a server. 


Sessions disconnected. The number of server sessions disconnected normally or ended in error. 
Sessions disconnected automatically. The number of server sessions disconnected automatically. 
Session identifier. Unique identifier for the server session. 

Session idle time. The number of seconds a session has been idle. 

Session starts. The number of server session starts. 

Session time. The number of seconds since the session was established. 

Share name. The network name of the resource. 

Spooled file type. The type of spooled files that will be created using this share. Values can be: 


ZI User ASCII (*USERASCID, 


2 Advanced Function Printing (*AFP) 
3 Simplified Character Set (*SCS) 


4 Automatic type sensing 


Text description. An optional comment about the shared resource or computer. 
Unknown users. The number of unknown users that have requested sessions to the server. 
User name. The name of the user that is associated with the connection. 

User profile name. The name of the user that is associated with the resource. 


User space library name specified. The user space library name that was passed to this API on the call in 
the qualified user space name parameter. 


User space name specified. The user space name that was passed to this API on the call in the qualified 
user space name parameter. 


WINS enablement. This system may use the services of a Windows Internet Name Service (WINS) server. 
Possible values are: 


0 Do NOT use WINS server. 


l Use WINS server. 


WINS primary address. The IP address of the primary Windows Internet Name Service (WINS) server. 


WINS secondary address. The IP address of the secondary Windows Internet Name Service (WINS) 
server. 


Workstation name. The name of the workstation from which the session to the server was established. 


Error Messages 


Message ID Error Message Text 

CPF3CIEE Required parameter &1 omitted. 

CPF3CF1E — Error code parameter not valid. 

CPF3CF2E — Error(s) occurred during running of &1 API. 
CPFAOD4 E File system error occurred. 

CPFB682E API &1 failed with reason code &2. 

CPFB683 E Data conversion failed for API &1. 

CPFB684E — User does not have the correct authority for API &1. 


CPFB686E _ Error configuring iSeries Support for Windows Network Neighborhood (iSeries 
NetServer). 


CPFBO68FE _ Error listing iSeries Support for Windows Network Neighborhood (iSeries NetServer) 
information. 


CPFB693 E Data conversion failed for &5 API. 


CPIB685E Error occurred on iSeries Support for Windows Network Neighborhood (iSeries 
NetServer) request. 


API Introduced: V4R2 


Top | Server Support APIs | APIs by category 


Open List of Server Information (QZLSOLST) 
API 


Required Parameter Group: 


Receiver variable Char(*) 
Length of receiver variable Binary(4) 
List information Char(64) 
Format Char(8) 
Information qualifier Char(15) 
Error code Char(*) 


Optional Parameter 1: 


7 Session user Char(10) 


Optional Parameter 2: 


8 Session identifier Binary(8) 


Default Public Authority: *USE 


Threadsafe: No 


The Open List of Server Information (QZLSOLST) API opens a list of information about the server for 
share, configuration, session, statistics, or connection information. You may use the information qualifier 
function to open a list of just the information in which you are interested. 


Authorities and Locks 


To use the *RESET qualifier for the ZLSLO400 format, you must have *IOSYSCFG special authority. 


Required Parameter Group 


Receiver variable 
OUTPUT; CHAR(*) 


The variable used to return the server information. For details about the structure of the receiver 
variable, see Format of Receiver Variable. 


Length of receiver variable 
INPUT; BINARY(4) 


The length of the receiver variable. 
List information 
OUTPUT; CHAR(64) 


The information about the list of information that was opened. For a layout of this structure, see 
List Information Section. 


Format 
INPUT; CHAR(8) 


The content and format of the information to be returned about the iSeries Support for Windows 
Network Neighborhood server. Possible format names follow: 


ZLSLOIOO Share information 

ZLSLOIO1 Same as ZLSLO100, plus extension information 
ZLSLO200 Configuration information 

ZLSLO201 Same as ZLSLO200, plus allow system name 
ZLSLO300 Session information 

ZLSLO400 _ Statistical information 

ZLSLO600 Session connection information 

ZLSLO700 Share connection information 

ZLSLO800 Share type information 

ZLSLO900 Disabled user profiles 


For more information, see Format of Receiver Variable. 


Information qualifier 
INPUT; CHAR(15) 


A restriction on the information to be retrieved. This parameter allows the caller to request a subset 
of the entries that would normally be returned on a given format. Currently, this parameter applies 
only to the ZLSLO100 and ZLSLO101 (share information), ZLSLO300 (session information), 
ZLSL0400 (statistical information), ZLSL0600 (session connection information), ZLSLO700 (share 
connection information), and ZLSLO0800 (share type information) formats. 


For formats ZLSLO200 and ZLSL0201, this parameter is ignored. 

For format ZLSLO300, a valid session name, *SESSID, or *ALL is allowed. 
For format ZLSL0400, only the *ALL and *RESET qualifiers are valid. 

For format ZLSL0600, a valid session name or *SESSID is required. 

For format ZLSLO700, a valid share name is required. 

For format ZLSL0800, only the *ALL qualifier is valid. 

For format ZLSLO900 this parameter must be all blanks. 


If this parameter is all blanks or is *ALL, no information qualification is performed. Allowable 
values include: 


Information name Information about the specified list entry only. 


Generic information name All information matching the generic string of the specified format. 
*ALL All information of the specified format. 


*RESET Statistical information is reset to zero. This parameter is valid for 
the ZLSL0400 format only. When the *RESET qualifier is 
specified, the values will be reset to zero before they are listed. 


*SESSID The information returned is for the session indicated by the session 
identifier parameter. When this value is specified for this parameter, 
*SESSID must be specified for the session user parameter. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Optional Parameter 1 


Session user 
INPUT; CHAR(10) 


Allows the caller to restrict the session information to be retrieved. This parameter is ignored if a 
generic information name, or *ALL, is specified on the information qualifier parameter. Currently, 
this parameter applies only to the ZLSLO300 (session information) and ZLSL0600 (session 
connection information) formats. Allowable values include: 


*ALL The information returned is for all users of a specific session. 


*SESSID The information returned is for the session indicated by the session 
identifier parameter. When this value is specified for this parameter, 
*SESSID must be specified for the information qualifier parameter. 


Session user name Information about the specified user only. 


If the session user parameter is omitted, the API assumes a value of *ALL. 


Optional Parameter 2 


Session identifier 
INPUT; BINARY(8) 
Allows the caller to restrict the session information to be retrieved to a single session. This 
parameter must be 0 if any value other than *SESSID is specified on the information qualifier and 


session user parameters. Currently, this parameter applies only to the ZLSL0300 (session 
information) and ZLSLO600 (session connection information) formats. Allowable value are: 


0 All information of the specified format. 


Session identifier Information returned is for the specified session only. 


If the session identifier parameter is not specified, the API assumes a value of 0. 


Format of List Information 


The following table shows the format of the list information parameter. For detailed descriptions of the 
fields in the table, see Field Descriptions. 


| Offset 
es Hex |Type Field 


Field Descriptions 


Date and time created. The date and time when the list was created. The 13 characters are: 
I Century, where 0 indicates years 19xx and 1 indicates years 20xx. 
2-7 Date, in YYMMDD (year, month, and day) format. 


S-13 Time of day, in HHMMSS (hours, minutes, and seconds) format. 


Information complete indicator. Whether all information requested has been supplied. 
C Complete and accurate information. All the buffers requested are read and returned. 


I Incomplete information. An interruption causes the list to contain incomplete information about a 
buffer or buffers. 


Length of information returned. The size in bytes of the information returned in the receiver variable. 
Record length. The length of each record of information returned. For variable length records, this value 
will be set to zero. For variable length records, you can obtain the length of individual records from the 
records themselves. 

Records returned. The number of records returned in the receiver variable. 


Reserved. Field not used currently. It should be initialized to hexadecimal zeroes (x'00's). 


Total records. The total number of records available in the list. 


Format of Receiver Variable 


There are ten possible formats for the receiver variable: 
ZLSLO100 
ZLSLO101 
ZLSL0200 
ZLSLO201 
ZLSLO0300 
ZLSLO400 
ZLSL0600 
ZLSL0700 
ZLSLO0800 
ZLSLO900 


The layout of the contents of the receiver variable is determined by the format used. The following tables 
show how the contents of the receiver variable is organized. For descriptions of each field, see Field 


Descriptions. 


When you retrieve list entry information from the receiver variable, you must use the entry size returned in 
the list information as a displacement to the next list entry for formats ZLSLO200, ZLSLO201, ZLSL0300, 
ZLSL0400, ZLSL0600, ZLSLO700, ZLSLO800, and ZLSLO900. For formats ZLSLO100 and ZLSLO101, 
use the length of this entry field at the start of each entry to calculate the displacement to the next list entry. 
The size of each entry may be padded at the end. If you do not use the entry size, the result may not be 
valid. 


ZLSLO100 Format 


| Offset 
| D c | Hex |Type Field 


Sa 
[ 4 | 4 |CHAR(2) |Shaename  ==———“<i‘“‘i‘“‘“‘~C~C:*™*™~C~™ 
| 16 | 10 |BINARY(4) [Devicetype | 
[20 [4 BINARY) [Permissions 
[ 18 |BINARY(4) [Maximumusers 
Ee BINARY eats 
[32 [20 | 
| 36 ER 


INARY.@) Specie le ype 
BEC Sl SOC 


ZLSLO101 Format 


| Offset 
| Dec | Hex |Type Field 


[| 4 [| 4 |CHAR(2) 9 |Sharename 
| 24 [| 18 |BINARY(4) [Maximumusers 9 
[ 32 [ 20 |BINARY(4) [Spooledfiletype = s—s—S 
| 36 [| 24 |BINARY(4) — [Offset to path name (ZLSLOIOI format) 
| 40 [| 28 |BINARY(4)  |Lengthofpahname = = = = 
| 44 | 2C |CHAR@0) [Qualified outputqueue—~—~—SCS~*S 
| 64 [| 40 |CHAR(S0) ~ |Printdrivertype = = 
[114 | 72 |CHARG0)  [Textdescription —~S~CS~*~*~CS 
[164 | ~A4 |CHAR@0) |Qualifiedprinterfile + ~~~—SCS 
[ 184 | B8 [BINARY(4) [CCSID used for text conversion 

[ 192 [ CO |BINARY(4) [Number oftableentries = 
| 196 | C4 [CHAR(1) [Enable text conversion 

| 197 [ CS |CHAR() — |Publishprintshare 


These fields BINARY(4) Length of file extension 
repeat for each 

file extension |CHAR(46) File extension 

table entry. 


ZLSLO200 Format 


| Offset 
| Dec | Hex |Type Field 


CN 
oz BINARY) [ldletimeout 
[20 [14 |BINARY@) [Pending opportunistic lock time-out 


[32 | 20 |BINARY@) |WINSenablement—~——~—~—~S~S 
[40 | 28 |BINARY@) |Guestsuppot—=—=~=~=~S~CS*~*~<CS 
[258 | 102 |CHARGS)  |WINS secondary address ~—~S~S~S~S~S~S~*S 
[288 | 120 |CHAR@24) |ScopeID ~—~S~CS*~CS 


ZLSLO201 Format 


| Offset 
ee EE c || Hex |Type Field 


ana ees 
ae (oll DRDO [Pending browsing interval —~—~—~S~S~S~S~S 


[258 | 102 |CHARCS)  |WINS secondary address ~=~S~S~S~S~S~*S 
[288 | 120 |CHAR@24) |ScopeID ~~=~SOSCS*~*~CS 
[ 736 | 260 |CHARG) [Allow systemname —~—~—~S*S 


ZLSLO300 Format 


| Offset 
| Dec | Hex /|Type Field 


| 48 | 30 |CHAR() ~~ [Logontype 


ZLSL0400 Format 


| Offset 
es c || Hex |Type Field 


—— 4 BINERYG)— Bais obs gel 
[ 8 | 8 [BINARY(4) [Sessionstarts = = = = = ss 
| 12 [| C  |BINARY() [Sessions disconnected automatically = 
LT BINARY _[Bessons disconnected 
[ 2 [1 [CHAR(8) [Reserved 

a IC |BINARY(4) [Password violations = 
[32 | 20 |BINARYG) |Guestsuppot=~=~=~S~CS~*~<“C~S*S 
| 36 [ 24 |BINARY(4) [Unknownusers = 
| 40 [| 28 |BINARY(4) [Number of bytessent(low) = 
[ 44 | 2C [BINARY [Number of bytes sent (high) —~—~=~S~* 
| 48 | 30 [BINARY(4) [Number of bytes received (low) 

| 52 [| 34 |BINARY(4) — [Number of bytes received (high) = 
| 56 | 38 |BINARY(4) |Averageresponsetime = 
| 60 [| 3C |CHAR(3)  [Dateandtime started = 
| 73 | 49 |CHAR(3) ~~ |Dateandtimeresett == 
| 86 | 56 |CHAR(@) ~~ [Reserved 


ZLSLO600 Format 


| Offset 
| Dec | Hex /|Type Field 


ZLSLO700 Format 


| Offset 
ae c | Hex |Type Field 


| | [BINARY (4) [Connection ID 
| 4 | 4 [BINARY(4) [Connection type 


ZLSLO800 Format 


| Offset 
ae c | Hex |Type Field 


| | |[CHAR(12) [s hare name 
| 12 C [BINARY (4) [Device type 


ZLSLO900 Format 


| ss Offset 
ep na | Hex Type Field 
This field repeats for |CHAR(10) iSeries Netserver user name 
each user. 


Field Descriptions 


Allow system name. Whether the server allows clients to connect using the system name found in the 


iSeries network attributes. Possible values are: 
O Do not allow access to the server using the system name. 


I Allow access to the server using the system name. 


2Authentication method. The method used to authenticate users. Possible values are: 
character 0 The server authenticates with encrypted passwords. 


character 1 The server authenticates with Kerberos v5 tokens.*& 


Average response time. The average server response time in milliseconds. 


Browsing interval. The amount of time, in milliseconds, between each browsing server announcement. 
CCSID. The coded character set ID (CCSID) that is used by all clients connected to the server. 


Note: The field in the corresponding header file for this format may indicate code page, but the value 
returned will be the CCSID. 


CCSID used for text conversion. The CCSID that is used for text file data conversion. 


Note: The field in the corresponding header file for this format may indicate code page, but the value 
returned will be the CCSID. 


Connection ID. The number that identifies the connection. 
Connection time. The number of seconds since the connection was established. 


Connection type. The type of the connection made from the workstation to the shared resource. Possible 
values are: 


0 Disk drive 


ZI Spooled output queue 


Current users. The number of connections that are currently made to the resource. A value of -1 
(X'FFFFFFFF') means that the server was unable to retrieve the actual value. 


Date and time reset. The date and time when the server statistics were reset. The 13 characters are: 


I Century, where 0 indicates years 19xx and 1 indicates years 20xx. 
2-7 Date, in YYMMDD (year, month, and day) format. 


S-13 Time of day, in HHMMSS (hours, minutes, and seconds) format. 


Date and time started. The date and time when the server was started. The 13 characters are: 


I Century, where 0 indicates years 19xx and 1 indicates years 20xx. 
2-7 Date, in YYMMDD (year, month, and day) format. 


$-13 Time of day, in HHMMSS (hours, minutes, and seconds) format. 


Device type. One of the following values: 
0 Disk drive 


ZI Spooled output queue 


Domain name. The name of the domain in which the iSeries Support for Windows Network Neighborhood 
server is a member. 


Enable text conversion. Whether the server enables text conversion for this share. Possible values are: 
O Text conversion not enabled 


1 Text conversion enabled 


2 Text conversion enabled and mixed data is allowed 


Encrypted password. Whether the the encrypted password was used to establish the session to the server. 
Possible values are: 


0 Anencrypted password was not used to establish the session 


I Anencrypted password was used to establish the session 


File extension. A file extension string that is null-terminated. Possible values include: 
% The server will convert all files. 
The server will convert all files without an extension. 
TXT, .TXT The server will convert all files ending with .TXT (that is, a. TXT, a.b.c. TXT). 


TXT, ...TXT, ...... TXT Extensions with more than one leading period will have no effect on the server. 
No translation will be done. 


T*T The server will convert all files ending with an extension that substitutes any 
number of characters for the * wild card (that is, a.T123T, b. TXT, c. TEST). 


T?T The server will convert all files ending with an extension that substitutes any 
one character for the ? wild card (that is, a.T1T, b. TXT). 


File opens. The number of file opens for the whole server. 


Guest support. A guest user profile may be used in the event an unknown user attempts to access resources 
on the system. Possible values are: 


O Use of guest user profile not supported 


I Use of guest user profile supported 


Guest user profile. The user profile to be used in the event an unknown user attempts to access resources 
on the system. 


Idle time-out. The amount of time, in seconds, a connection to the simplified server remains active once 
activity has ceased on that connection. 


iSeries NetServer user name. The name of an iSeries NetServer user. 


Length of file extension. The size in bytes of the file extension. The length does not include the byte used 
for null-termination. 


Length of path name. The length of the local path name of the shared resource in bytes. 

Length of this entry. The total length of the list entry in bytes. 

Logon type. The type of authentication used to connect to the server. Possible values are: 
O Authentication using the defined guest user profile 


J Regular user authentication 


Maximum users. The maximum number of concurrent connections that the shared resource can 
accommodate. This number is unlimited if the value is -1. 


Number of bytes received (high). The number of server bytes received from the network (high-order bits 
of 8-byte combinations of both number of bytes received fields). 


Number of bytes received (low). The number of server bytes received from the network (low-order bits of 
8-byte combinations of both number of bytes received fields). 


Number of bytes sent (high). The number of server bytes sent to the network (high-order bits of 8-byte 
combinations of both number of bytes sent fields). 


Number of bytes sent (low). The number of server bytes sent to the network (low-order bits of 8-byte 
combinations of both number of bytes sent fields). 


Number of connections. The number of connections made during the session. 
Number of connection users. The number of users on the connection. 
Number of files open. The number of files that are open currently. 


Number of sessions. The number of sessions that are established between the server and the requester. 


Number of table entries. The number of file extension entries in the file extension table. 
Offset to extension table. The offset from the start of returned data where the file extension table starts. 


Offset to path name (ZLSL0100 format). The offset from the start of the record to where the path name 
of the shared resource starts. 


Offset to path name (ZLSL0101 format). The offset from the start of the returned data to where the path 
name of the shared resource starts. 


Opportunistic lock (oplock) time-out. The amount of time, in seconds, an opportunistic lock is left 
enforced for a resource. Currently, this function is not supported. 


Password violations. The number of server password violations. 


Path name. A path in the integrated file system. The path name is stored internally in unicode format; 
when listed, it is converted into the CCSID of the current job. 


Pending allow system name. Whether the server allows clients to connect using the system name found in 
the network attributes the next time the server is started. Possible values are: 


0 Do not allow access to the server using the system name 


I Allow access to the server using the system name. 


Pending authentication method. The method that will be used to authenticate users the next time the 
server is started. Possible values are: 


character 0 The server will authenticate with encrypted passwords. 


character 1 The server will authenticate with Kerberos v5 tokens.*& 


Pending browsing interval. The amount of time, in seconds, to be used the next time the server is started, 
between each browsing server announcement. 


Pending CCSID. The CCSID that is used by all clients connected to the server the next time the server is 
started. 


Note: The field in the corresponding header file for this format may indicate code page, but the value 
returned will be the CCSID. 


Pending domain name. The name of the domain in which the server will be a member the next time the 
server is started. 


Pending guest support. A guest user profile may be used the next time the server is started in the event an 
unknown user attempts to access resources on the system. Possible values are: 


O Use of guest user profile not supported. 


I Use of guest user profile supported. 


Pending guest user profile. The user profile to be used the next the time the server is started in the event 
that an unknown user attempts to access resources on the system. 


Pending idle time-out. The amount of time (in seconds) to be used the next time the server is started so 
that a connection to the server will remain active once activity has ceased on that connection. 


Pending opportunistic lock time-out. The amount of time an opportunistic lock (oplock) is left enforced 
for a resource to be used the next time the server is started. Currently, this function is not supported. 


Pending scope ID. A string that names the network scope to be used by the Windows Internet Name 
Service (WINS) server the next time the server is started. 


Pending server name. The name the server will be known as on the system the next time the server is 
started. 


Pending server role. The value that determines the logon server role for this system the next time the 
server is started. Possible values are: 


0 System will not be a server. 


ZI System will be a server. 


Pending text description. An optional comment about the shared resource to be used the next time the 
server is started. 


Pending WINS enablement. Whether this system uses the services of a Windows Internet Name Service 
(WINS) server the next time the server is started. Possible values are: 


0 Donot use WINS server 


1 Use WINS server 


Pending WINS primary address. The IP address of the primary Windows Internet Name Service (WINS) 
server to be used the next time the server is started. 


Pending WINS secondary address. The IP address of the secondary Windows Internet Name Service 
(WINS) server to be used the next time the server is started. 


Permissions. Permissions to be applied against the disk for sharing. Possible values are: 


I Read only 


2 Read/write 


Print driver type. The text string that identifies the print driver appropriate for this share. When personal 
computers connect to this shared printer, this identifies the print driver they should use. This text should 
match the name of a print driver known to the personal computer operating system. 
Print jobs queued. The number of server print jobs spooled. 
Publish print share. Whether the print share is to be published. Possible values are: 

0 Print share is not published 


I Print share is published 


Qualified output queue. The name and library of the output queue. The first 10 characters identify the 
name of the output queue. The second 10 characters contain the library that contains the output queue. 


Qualified printer file. The name and library of the printer file. The first 10 characters identify the name of 
the printer file. The second 10 characters contain the library that contains the printer file. 


Reserved. Field not used currently. 


Scope ID. A string that names the network scope to be used by the Windows Internet Name Service 
(WINS) server. 


Server name. The name by which the server is known on the system. 
Server role. The value that determines the logon server role for this system. Possible values are: 
O System is not a server. 


1 System is a server. 


Sessions disconnected. The number of server sessions disconnected normally or ended in error. 
Sessions disconnected automatically. The number of server sessions disconnected automatically. 
Session identifier. Unique identifier for the server session. 
Session idle time. The number of seconds a session has been idle. 
Session starts. The number of server session starts. 
Session time. The number of seconds that a session has been active. 
Share name. The network name of the resource. 
Spooled file type. The type of spooled files that will be created using this share. Values can be: 
ZI User ASCII (*USERASCID) 
2 Advanced Function Printing (*AFP) 
3 Simplified Character Set (*SCS) 


4 Automatic type sensing 


Text description. An optional comment about the shared resource or computer. 
Unknown users. The number of unknown users that have requested sessions to the server. 
User name. The name of the user that is associated with the connection. 

User profile name. The name of the user that is associated with the resource. 


WINS enablement. This system may use the services of a Windows Internet Name Service (WINS) server. 
Possible values are: 


0 DoNOT use WINS server. 


l Use WINS server. 


WINS primary address. The IP address of the primary Windows Internet Name Service (WINS) server. 


WINS secondary address. The IP address of the secondary Windows Internet Name Service (WINS) 
server. 


Workstation name. The name of the workstation from which the session to the server was established. 


Error Messages 


Message ID Error Message Text 
CPF3C1IEE Required parameter &1 omitted. 
CPF3CF1E — Error code parameter not valid. 


CPFB688 E — Error opening iSeries Support for Windows Network Neighborhood (iSeries NetServer) 
information. 


API Introduced: V4R2 


Top | Server Support APIs | APIs by category 


Remove Server Share (QZLSRMS) API 


Required Parameter Group: 


1 Share name Input Char(12) 
2 Error code V/O Char(*) 


Default Public Authority: *USE 


Threadsafe: No 


The Remove Server Share (QZLSRMS) API removes a share from the list of files or printers on the server. 
When this function removes a share, all connections to the shared resource are disconnected. 


Authorities and Locks 


To use this API, you must have *IOSYSCFG special authority, own the integrated file system directory, or 
own the system output queue that the share references. 


Required Parameter Group 
Share name 
INPUT; CHAR(12) 


The name of the share to be removed. 
Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Error Messages 


Message ID Error Message Text 

CPF3CIE E Required parameter &1 omitted. 

CPF3CF1 E Error code parameter not valid. 

CPF3CF2 E Error(s) occurred during running of &1 API. 
CPFA0D4 E File system error occurred. 


CPFB682 E API &1 failed with reason code &2. 


CPFB683 E 
CPFB684 E 
CPFB68A E 
CPFB68B E 
CPFB693 E 
CPIB685 E 


Data conversion failed for API &1. 

User does not have the correct authority for API &1. 
Error occurred while working with shared resource &2. 
Character is not valid for value &3. 

Data conversion failed for &5 API. 


Error occurred on iSeries Support for Windows Network Neighborhood (iSeries 
NetServer) request. 


API Introduced: V4R2 


Top | Server Support APIs | APIs by category 


Start Server (QZLSSTRS) API 


Required Parameter Group: 


1 Reset qualifier Input Char(1) 
2 Error code V/O Char(*) 


Default Public Authority: *USE 


Threadsafe: No 


The Start Server (QZLSSTRS) API starts the jobs necessary for the iSeries Support for Windows Network 
Neighborhood server to run. If the jobs are already running, the API will fail. 


This API does not start the QSERVER subsystem (in which the jobs run). If the QSERVER subsystem is 
not running, the API will fail. 


Authorities and Locks 


To use this API, you must have *IOSYSCFG special authority. 


Required Parameter Group 
Reset qualifier 
INPUT; CHAR(1) 
Whether the server is reset when started. Possible values are: 


O Server not reset 


1 Server reset 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Error Messages 


Message ID Error Message Text 


CPF3CIE E Required parameter &1 omitted. 


CPF3CF1 E 
CPF3CF2 E 
CPFB682 E 
CPFB684 E 
CPFB685 E 


Error code parameter not valid. 

Error(s) occurred during running of &1 API. 

API &1 failed with reason code &2. 

User does not have the correct authority for API &1. 


iSeries Support for Windows Network Neighborhood (iSeries NetServer) was unable 
to start. 


API Introduced: V4R2 


Top | Server Support APIs | APIs by category 


Integrated Operating Environments APIs 


The Integrated Operating Environments APIs provide information about operating environments, such as 
Windows, that are integrated with OS/400. For example, attributes of integrated servers can be retrieved, as 
well as attributes of virtual disk drives and users that are associated with integrated servers. 


The Integrated Operating Environments APIs are: 


e Open List Network Server Storage Spaces (QFPADOLD) retrieves a list of storage spaces (virtual 
disk drives) that can be linked to a server. 


e Open List Network Server Users (QFPADOLU) generates a list of Windows domains and servers, 
and the associated profiles enrolled to them in the network. 


e Open List Network Servers (QFPADOLS) retrieves a list of servers. 


e Process Network Server User (QFPADPNU) performs an error recovery operation on a selected 
user or group enrollment entry for a particular Windows domain or server. 


e Retrieve Network Server Information (QFPADRNI) retrieves information from a Windows server. 


e@ Retrieve Network Server User Attributes (QFPADRUA) retrieves the network server attributes for 
a user or a group. 


Top | Server Support APIs | APIs by category 


Open List Network Server Storage Spaces 
(QFPADOLD) API 


Required Parameter Group: 


Receiver variable Char(*) 
Length of receiver variable Binary(4) 
List information Char(80) 
Number of records to return Binary(4) 
Format name Char(8) 
Storage space name qualifier Char(*) 
Length of storage space name qualifier Binary(4) 
Network server description name Char(*) 
qualifier 

Length of network server description Binary(4) 
name qualifier 

Error code Char(*) 


1 
2 
3 
4 
5 
6 
7 
8 


Default Public Authority: *USE 


Threadsafe: No 


The Open List Network Server Storage Spaces (QFPADOLD) API retrieves a list of storage spaces (virtual 
disk drives) that can be linked to a server. The functions provided by this API are similar to the Work with 
Network Server Storage Spaces (WRKNWSSTG) command. 


Authorities and Locks 


Network Server Storage Space Authority 
*RX for IFS directory /QFPNWSSTG 
*RX for IFS directory /QFPNWSSTG/name 
*R for the files in IFS directory /QFPNWSSTG/name 


Note: In the above file paths, 'name'’ is the name of the storage space. 


Network Server Storage Space Lock 


None 


Required Parameter Group 


Receiver variable 
OUTPUT; CHAR(*) 


The receiver variable that receives the information requested. You can specify the size of the area 
to be smaller than the format requested as long as you specify the length parameter correctly. As a 
result, the API returns only the data the area can hold. 


Length of receiver variable 
INPUT; BINARY(4) 
The length of the receiver variable provided. The length of the receiver variable parameter may be 
specified up to the size of the receiver variable specified in the user program. If the length of the 


receiver variable parameter specified is larger than the allocated size of the receiver variable 
specified in the user program, the results are not predictable. The minimum length is 0 bytes. 


List information 
OUTPUT; CHAR(80) 


Information about the list created by this program. For a description of the layout of this parameter, 
see Format of List Information. 


Number of records to return 
INPUT; BINARY(4) 


The number of records in the list to put into the receiver variable. The value must be 0 or greater. 
Format name 
INPUT; CHAR(8) 


The format of the information returned. You must use the following format name: 


DOLDOI00 The output storage space list structure. For more information, see DOLD0100 
Format. 


Storage space name qualifier 
INPUT; CHAR(*) 


A restriction on the information to be retrieved. This parameter allows the caller to request a subset 
of the records that normally would be returned on a given format. If this parameter is *ALL, no 
information qualification is performed. Allowable values are: 


*ALL Information about all storage spaces. 
Storage space name Information about the specified storage space name record only. 


Generic storage space name* Information about storage spaces matching the generic storage 
space name string. 


Length of storage space name qualifier 
INPUT; BINARY(4) 


The length of the storage space name qualifier. 
Network server description name qualifier 
INPUT; CHAR(*) 


A restriction on the information to be retrieved. This parameter allows the caller to request a subset 
of the records that normally would be returned on a given format. If this parameter is *ALL, no 


information qualification is performed. Allowable values are: 


*ALL Information about storage spaces for all network server 
descriptions, including storage spaces that are not linked to a 
network server description. 


Network server description name Information about storage spaces linked to the specified 
network server description name only. 


Length of network server description name qualifier 
INPUT; BINARY(4) 


The length of the network server description name qualifier. 
Error code 
T/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. If this parameter is omitted, diagnostic and escape messages are issued to the 
application. 


DOLDO100 Format 


Format DOLDO100 returns storage space information. 


[Offset 
= c | Hex |Type Field 


[8 | 8 |CHARGO) [Name ~~SCSCS~CS 
a 48 |BINARYG@) [Percentused ~~—~S~SCS 
am aC BINARY) —"[Dikpook 
[Sioa | 68 [BINARYG@) [Clustering quorum resource disk SS 
These fields |BINARY@)  [Dynamiclink —~—~S~SCSCS 
repeat for each [BINARY(4) {Link sequence position = 
server entry —s 


BINARY(4) Displacement to server name 
BINARY(4) Length of server name 
CHAR(*) Server name 


Field Descriptions 


Access to storage space. The type of access the server has to the storage space data. The possible values 
follow: 


0 Exclusive update - update access; not shared 
I Shared read - read access; storage space shared with other servers 


22 Shared update - update access; storage space shared with other servers * 


Capacity. The size of the storage space, in megabytes (MB). 


Clustering quorum resource disk. Whether the storage space was created as a cluster quorum resource 
disk. 


0 This storage space is not a cluster quorum resource disk. 


1 This storage space is a cluster quorum resource disk. *& 


Description. The text description of the storage space. 
Disk pool. The disk pool that contains the storage space. 
vi System disk pool 
2-32 User disk pools 


2» 33-255 Independent user disk pools 


Disk pool name. The device description name for the independent user disk pool that contains the 
storage space.*& 


Displacement to list of server entries. The displacement in bytes from the beginning of the record to the 
list of network server descriptions that are linked to the storage space. If there are no network server 
descriptions linked to the storage space, this value is zero. 


Displacement to next storage space record. The displacement in bytes from the beginning of the record to 
the next storage space record. If this is the last record, this value is zero. 


Displacement to server name. The displacement in bytes from the beginning of the server list entry to the 
server name. 


Dynamic link. Whether the storage space was linked to the server dynamically. The possible values follow: 
0 The storage space was not linked dynamically. 


I The storage space was linked dynamically. 


Length of server list entries. The length of each server entry. 
Length of server name. The length of the server name. 
Length of storage space record. The length of the data for the current storage space. 


2Link sequence position. The relative order that storage spaces are linked to the network server 
description. Storage spaces appear to Windows in the order specified by the link sequence position value. 
There are several types of storage space links. The link types and the corresponding link sequence position 
ranges are as follows: 


Fixed Links of this type have the dynamic link value set to 0. The link sequence 
position values range from | to 16. 


Cluster quorum resource Links of this type have the clustering quorum resource disk value set to 1 
and the access to storage space value set to 2. The link sequence position 
value is 1. 
Note: This link type only applies to Windows servers. 


Cluster shared Links of this type have the clustering quorum resource disk value set to 0 
and the access to storage space value set to 2. The link sequence position 
values range from 1 to 15. 
Note: This link type only applies to Windows servers. 


Dynamic Links of this type have the dynamic link value set to | and the criteria for 


the above link types is not met. The link sequence position values range from 
1 to 64. 


The storage spaces appear to the server grouped by the above link types and in the link type order shown 
above. Within each link type group, the storage spaces appear to the server in the order of the link sequence 
position values.*& 


Name. The name of the storage space. 


Network server description name. The name of the network server description that is linked to the storage 
space. 


Number of server list entries. The number of server entries. 

Percent used. The percentage of the storage space capacity that is occupied by data. 
2Reserved. Reserved area for 4-byte boundary alignment.“ 

Server name. The name of the server that is linked to the storage space. 


Storage space format. The file system format that is used for the storage space. The possible values 
follow: 


0 High performance file system (HPFS) 
I File Allocation Table (FAT) file system 
NetWare file system 


AIX file system 


KR &w N 


Windows NT file system (NTFS) 


6 32-bit File Allocation Table (FAT-32) file system 
= 7 Open source file system 
254 Unknown (the storage space contains an unknown format type)*& 


255 Pending (the storage space is in the process of being created) 


Storage space formatting status. Whether the storage space is properly formatted for the specified file 
system format and ready to use. The possible values follow: 


0 Unknown 
I Complete 


2 Incomplete 


Format of List Information 


The following table shows the format of the list information parameter. For detailed descriptions of the 
field in the table, see Field Descriptions. 


| Offset 
| Dec | Hex |Type Field 


| 0 | 0 [BIN ARY(4) [Total records 

| 4 | 4 [BIN ARY(4) [Records returned 

| 8 | 8 |CHAR(4) [Request handle 

| 12 | C [BIN ARY(4) [Record length 

| 16 | 10 |CHAR(1) [Information complete indicator 
| 17 11 |CHAR(13) [Date and time created 

| 30 | 1E [CHAR(1) [List status indicator 

| 31 | 1F |CHAR(1) [Reserved 

| 32 | 20 [BIN ARY(4) [Length of information returned 
| 36 | 24 [BIN ARY(4) [First record in buffer 

| 40 | 28 |[CHAR(40) [Reserved 


Field Descriptions 


Date and time created. The date and time the list was created. The 13 characters are: 
I Century, where 0 indicates years 19xx and 1 indicates years 20xx. 
2-7 The date, in YYMMDD (year, month, day) format. 


S-13 The time of day, in HHMMSS (hours, minutes, seconds) format. 


First record in buffer. The number of the first record in the receiver variable. 
Information complete indicator. Whether all information requested has been supplied. 


I (x'C9") Incomplete information. An interruption caused the list to contain incomplete information 
about a buffer or buffers. 


P (x'D7’) Partial and accurate information. Partial information is returned when the maximum space 
was used and not all of the buffers requested were read. 


C_ x'C3') Complete and accurate information. All the buffers requested were read and returned. 


Length of information returned. The size, in bytes, of the information returned in the receiver variable. 
List status indicator. The status of the list building. The indicators are: 

0 The list building is pending. 

I The list is in the process of being built. 

2 The list has been built completely. 


3 Anerror occurred while building the list. The next call to QGYGTLE will cause the error to be 
signalled to the caller of QGYGTLE. 


Record length. The length of each record of information returned. For variable length records, this value is 
set to 0. For variable length records, you can obtain the length of individual records from the records 
themselves. 


Records returned. The number of records returned in the receiver variable. This is the smallest of the 
following values: 

e@ The number of records that fit into the receiver variable. 

e The number of records in the list. 

e The number of records requested. 


Request handle. The handle of the request that can be used for subsequent requests of information from the 
list. The handle is valid until the Close List (QGYCLST) API is called to close the list or until the job ends. 


Note: This field should be treated as a hexadecimal field. It should not be converted from one CCSID to 
another (for example, EBCDIC to ASCII) because doing so could result in an unusable value. 


Reserved. Reserved field. Must be set to hexadecimal or binary zero. 


Total records. The total number of records available in the list. 


Error Messages 


Message ID Error Message Text 

CPF24B4 E Severe error while addressing parameter list. 
CPF2634 E Not authorized to object &1. 

CPF3C17 E Error occurred with input data parameter. 
CPF3C19 E Error occurred with receiver variable specified. 


CPF3C1D E 
CPF3C1E E 
CPF3C1F E 
CPF3C21E 
CPF3C24 E 
CPF3CF1 E 
CPF3CF2 E 
CPF3C36 E 
CPF9806 E 
CPF9872 E 


Length specified in parameter &1 not valid. 

Required parameter &1 omitted. 

Pointer is not on a 16 byte boundary. 

Format name &1 is not valid. 

Length of the receiver variable is not valid. 

Error code parameter not valid. 

Error(s) occurred during running of &1 API. 

Number of parameters, &1, entered for this API was not valid. 

Cannot perform function for object &2 in library &3. 

Program or service program &1 in library &2 ended. Reason code &3. 


API Introduced: V5R1 


Top | Server Support APIs | APIs by category 


Open List Network Server Users (QFPADOLU) 
API 


Required Parameter Group: 


Receiver variable Char(*) 
Length of receiver variable Binary(4) 
List information Char(80) 
Number of records to return Binary(4) 
Format name Char(8) 
Profile type Char(10) 
Profile name Char(10) 
Windows domain name qualifier Char(*) 
Length of Windows domain name qualifier Binary(4) 
Windows server name qualifier Char(*) 
Length of Windows server name qualifier Binary(4) 
Error code Char(*) 


1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 


— 
N 


Default Public Authority: *USE 


Threadsafe: No 


The Open List Network Server Users (QFPADOLU) API generates a list of Windows domains and servers, 
and the associated profiles enrolled to them in the network. The list will be returned grouped by domain or 
server name, and within the domain or server, by profile name. 


Authorities and Locks 


User profile 
*READ 


Required Parameter Group 


Receiver variable 
OUTPUT; CHAR(*) 
The receiver variable that receives the information requested. You can specify the size of the area 


to be smaller than the format requested as long as you specify the length parameter correctly. As a 
result, the API returns only the data the area can hold. 


Length of receiver variable 
INPUT; BINARY(4) 


The length of the receiver variable provided. The length of the receiver variable parameter may be 


specified up to the size of the receiver variable specified in the user program. If the length of the 
receiver variable parameter specified is larger than the allocated size of the receiver variable 
specified in the user program, the results are not predictable. The minimum length is 0 bytes. 


List information 
OUTPUT; CHAR(80) 


Information about the list created by this program. For a description of the layout of this parameter, 
see Format of List Information. 


Number of records to return 
INPUT; BINARY(4) 


The number of records in the list to put into the receiver variable. The value must be 0 or greater. 
Format name 
INPUT; CHAR(8) 


The format of the information returned. You must use the following format name: 


DOLUOI00 Returns records for user and associated group records, or records for group and 
associated user records. 


Profile type 
INPUT; CHAR(10) 


Whether profile information returned is on a user profile or group profile basis. Values can be: 


*USER Retrieve information about profiles defined as users on the selected domains or 
servers. The group information for each group of which the user is a member is also 
returned. 


*GROUP Retrieve information about profiles defined as groups on the selected domains or 
servers. The users belonging to each group is returned also. 


*ALL Retrieve both group and user information for a single domain or server. All group 
records are returned first, without the associated user records. Then all user records 
are returned, without the associated group records. 


*NONE _ Retrieve information for domains and servers, but not for users or groups. Records 
for domains are returned first, followed by records for servers. No user or group 
records are returned. 


Profile name 
INPUT; CHAR(10) 


The names of the profiles to be included in the list. A specific profile can be specified, or the 
profile name can be specified with a generic name (such as 'USER*') to retrieve a list of all profiles 
starting with the specified letters. Allowable values are: 


*ALL Information about all profiles 
Profile name Information about the specified profile name record only. 


Generic profile name* Information about profiles matching the generic profile name string. 


Usage note: Avoid the use of characters 'SB'X, '7B'X, and '7C'X (CCSID 37 characters '$', '#', and 
‘@’, respectively) in profile names. 


Windows domain name qualifier 
INPUT; CHAR(*) 
The names of the Windows domains to be included in the list. A specific domain can be specified, 


or the domain name can be specified with a generic name (such as 'DMN*'’) to retrieve a list of all 
domains starting with the specified letters. Allowable values are: 


*ALL All domains with which users are enrolled are to be included in the 
list. 

*NONE No domains are to be included in the list. 

*NWSA Only the system default domains shown on the Display Network 


Server Attributes (DSPNWSA) command are to be included in the list. 
Domain name Information about the specified domain only. 


Generic domain name* Information about domains matching the generic domain name string. 


Length of Windows domain name qualifier 
INPUT; BINARY(4) 


The length of the Windows domain name qualifier. 
Windows server name qualifier 
INPUT; CHAR(*) 
The names of the Windows servers to be included in the list. A specific server can be specified, or 


the server name can be specified with a generic name (such as 'SRV*’) to retrieve a list of all 
servers starting with the specified letters. Allowable values are: 


*ALL All servers with which users are enrolled are to be included in the list. 
*NONE No servers are to be included in the list. 
*NWSA Only the system default servers shown on the Display Network Server 


Attributes (DSPNWSA) command are to be included in the list. 
Server name Information about the specified server only. 


Generic server name* Information about servers matching the generic server name string. 


Length of Windows server name qualifier 
INPUT; BINARY(4) 


The length of the Windows server name qualifier. 
Error code 
1/0; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 


Parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application. 


Format of Data Returned 


The list data returned for the DOLUO0100 format contains three types of records: 
Server records Contain information about a domain or server. 
User records _— Contain information about a user profile. 


Group records Contain information about a group profile. 


If the profile type requested is *USER, then records are returned as follows: 
e Server 1 

o User 1 for server 1 
m= Group | for user 1 
m Group 2 for user 1 
m Group n for user 1 

o User 2 for server 1 
m Group | for user 2 
m Group 2 for user 2 
m Group n for user 2 

o User n for server 1 


e Server 2 


If the profile type requested is “GROUP, then records are returned as follows: 
e@ Server 1 

o Group 1 for server 1 
m User 1| for group 1 
m User 2 for group 1 
m User n for group 1 

o Group 2 for server 1 
m User 1 for group 2 
m User 2 for group 2 


m User n for group 2 
o Group n for server 1 


e Server 2 


If the profile type requested is *ALL, then records are returned as follows: 
e Server 1 
o Group 1 for server 1 
o Group 2 for server 1 


o Group n for server 1 


o User | for server 1 
o User 2 for server 1 


o User n for server 1 


If the profile type requested is *NONE, then records are returned as follows: 
e Domain 1 
Domain 2 
Domain n 


e 

e 

e@ Server 1 
e@ Server 2 
e 


Server n 


DOLUO0100 Record Format 


The following table defines the structure of each record returned for format DOLU0100. 


| Offset 
| D c | Hex |Type Field 


a BINARY@) J 
aa 
[ 4 [8 
[28 [ic 


BINARY@)  [Displacementtoname ——~—~—~S~*S 
i BINARY@) [Enrollment reason —~—~C~S~S 
oa GARY — Messe ie 
[120 | 78 |CHAR@)  |MessageID~=~S~CS*~*~<“C~S*S 


See See |CHAR(*) Name 

note note 
Note: The displacement to the name is specified in the displacement to name 
variable. 


DOLU0100 Record Field Descriptions 


Displacement to name. The displacement in bytes from the beginning of the record to the name. 


Displacement to next record. The displacement in bytes from the beginning of the record to the next 
record. If this is the last record, this value will be zero. 


Enrollment error code. This value is only specified if the record is a user or group type record. Normally 
it is blank, but it will be set to the last enrollment error code that was received while attempting to create, 
delete, or update a user on a server. This should only be non-blank if the profile is in one of the recovery or 
delete statuses. 


The enrollment error codes are: 
239 User enrollment failed because the password can not be retrieved. 
245 User enrollment failed because the password can not be retrieved. 
247 Update of group failed because domain group type cannot be changed. 


249 Unable to delete group from Windows domain or server. 


U 
U 
248 Unable to delete user from Windows domain or server. 
U 
260 User not created because specified name is a reserved name in Windows. 
261 Group not created because specified name is a reserved name in Windows. 
262 User not deleted because specified name is a reserved name in Windows. 
263 Group not deleted because specified name is a reserved name in Windows. 
264 Enrollment request cannot complete because domain controller not found. 
265 User not created because user template not found. 
266 User not created because user name already exists. 
267 Create or update of user failed for an unknown reason. 
268 Create or update of group failed for an unknown reason. 


269 User was created or updated successfully on Windows. The user, however, was not added to the 
AS400_Users group on Windows. 


270 A request to delete the user from Windows failed because the user is a member of the 
AS400_Permanent_Users group on Windows. 


271 A request to delete the group from Windows failed because the group is not empty on Windows. 
272 Add user to an enrolled group failed on Windows. 

273 Create failed because user or group already exists on Windows. 

274 Add user to a group listed in the user template failed on Windows. 

275 User successfully enrolled, but not marked as enrolled on Windows. 


276 Group successfully enrolled, but not marked as enrolled on Windows. 


277 User unenrolled, but still marked as an enrolled user on Windows. 
278 Group unenrolled, but still marked as an enrolled group on Windows. 
279 Create or update of user failed on Windows; password not valid. 


280 Create or update user failed. A network server description (NWSD) associated with the Windows 
domain or server must be varied on. 


281 Enrollment request to local server not valid on domain controller. 
282 Service not authorized to manage domain groups and users on the domain. 


296 Unable to create home directory for user. 


Enrollment reason. This value is specified only if the record is a user type record. It indicates why a 
profile has been selected for enrollment: 


I The user is a member of a group that has enrolled members. 


2 The user is specifically enrolled to a domain or server. 


Length of name. The length of the name. 
Length of record. The length of the data for the current record. 


Member enrollment. This value is specified only if the record is a group type record. It indicates whether 
group members are enrolled. 


0 Group members are not enrolled. 


1 Group members are enrolled. 


Message file. This value is specified only if the record is a user or group type record. The message file that 
contains the message ID for a message that describes the enrollment error code for a failed enrollment 
operation. 


Message ID. This value is specified only if the record is a user or group type record. The message that 
describes the enrollment error code for a failed enrollment operation. 


Name. The name of a Windows domain, server, user, or group. 


Usage note: Avoid the use of characters 'SB'X, '7B'X, and '7C'X (CCSID 37 characters '$’, '#', and '@', 
respectively) in user and group profile names. 


Number records next lower level. The number of sub-records that exist for a record. For example, if the 
current record is a group record, followed by three user records for that group, then the number of records 
next lower level would be three. 


Number records to next record same level. The number of records to traverse to locate the next record of 
the same type (server, user, or group). If there are no more records of the same type, this value is zero. 


For example, if the current record is a group record, followed by three user records for the group, followed 
by another group record, then the number of records to next record same level would be four. 


Primary message file library. The library that contains the message file. This value is specified only if the 
record is a user or group type record. 


Note: If the message text is retrieved, use *LIBL (library list) as the message file library so that the correct 
national language version of the message text is retrieved. If the message file returned by this API is not in 
any of libraries in the library list, then message retrieval operation will fail with message CPF2407 
"Message file x in *LIBL not found." If this occurs, then attempt the retrieval operation again, using the 
primary message file library that is returned by this API. 


Profile description. The description for this profile. This value is specified only if the record is a user or 
group type record. 


Profile status. The current status of a user or group on a server. This value is specified only if the record is 
a user or group type record. The following values represent the various status values: 


I Profile is enrolled on the server (up-to-date). 
Enrollment pending on the server. 
Enrollment retry pending on the server. 
Enrollment failed. 

Unenrollment pending on the server. 
Unenrollment retry pending on the server. 


Unenrollment failed. 


Co NA UH KR WD NY 


Only group members enrolled. The users in the group are enrolled to the servers, but the group itself 
is not enrolled to the servers. This status is valid only for a group. 


Record type. The record type for a record. The values that represent the various types follow: 
I A server type record. 
2  A.user type record. 


3 A group type record. 


Note: The first record in the list is always a server type record. 


Server type. The type of server represented by the record. This value is specified only if the record is a 
server type record. 


1 A Windows domain. 


2 A Windows server. 


Format of List Information 


The following table shows the format of the list information parameter. For detailed descriptions of the 
field in the table, see Field Descriptions. 


| Offset 
| Dec Hex /|Type Field 


Field Descriptions 


Date and time created. The date and time the list was created. The 13 characters are: 
Il Century, where 0 indicates years 19xx and 1 indicates years 20xx. 
2-7 ‘The date, in YYMMDD (year, month, day) format. 


S-13 The time of day, in HHMMSS (hours, minutes, seconds) format. 


First record in buffer. The number of the first record in the receiver variable. 


Information complete indicator. Whether all information requested has been supplied. 


I Incomplete information. An interruption caused the list to contain incomplete information about a 


buffer or buffers. 


P Partial and accurate information. Partial information is returned when the maximum space was used 


and not all of the buffers requested were read. 


C Complete and accurate information. All the buffers requested were read and returned. 


Length of information returned. The size, in bytes, of the information returned in the receiver variable. 


List status indicator. The status of the list building. The indicators are: 
0 The list building is pending. 
I The list is in the process of being built. 


2 The list has been built completely. 


3 


An error occurred while building the list. The next call to QGYGTLE will cause the error to be 
signalled to the caller of QGYGTLE. 


Record length. The length of each record of information returned. For variable length records, this value is 
set to 0. For variable length records, you can obtain the length of individual records from the records 
themselves. 


Records returned. The number of records returned in the receiver variable. This is the smallest of the 


following values: 


e@ The number of records that fit into the receiver variable. 


e The number of records in the list. 


e The number of records requested. 


Request handle. The handle of the request that can be used for subsequent requests of information from the 
list. The handle is valid until the Close List (QGYCLST) API is called to close the list or until the job ends. 


Note: This field should be treated as a hexadecimal field. It should not be converted from one CCSID to 
another (for example, EBCDIC to ASCII) because doing so could result in an unusable value. 


Reserved. Reserved field. Must be set to hexadecimal or binary zero. 


Total records. The total number of records available in the list. 


Error Messages 


Message ID 
CPFA314 E 
CPF24B4 E 
CPF2634 E 

CPF3C19 E 
CPF3CIDE 
CPF3C21 E 
CPF3C36 E 
CPF3C3C E 
CPF3CF1 E 
CPF3CF2 E 
CPF9872 E 

CPF9999 E 


Error Message Text 

Memory allocation error. 

Severe error while addressing parameter list. 

Not authorized to object &1. 

Error occurred with receiver variable specified. 

Length specified in parameter &1 not valid. 

Format name &1 is not valid. 

Number of parameters, &1, entered for this API was not valid. 
Value for parameter &1 not valid. 

Error code parameter not valid. 

Error(s) occurred during running of &1 API. 

Program or service program &1 in library &2 ended. Reason code &3. 


Function check. &1 unmonitored by &2 at statement &5, instruction &3. 


API Introduced: V5R1 


Top | Server Support APIs | APIs by category 


Open List Network Servers (QFPADOLS) API 


Required Parameter Group: 


Receiver variable Char(*) 
Length of receiver variable Binary(4) 
List information Char(80) 
Number of records to return Binary(4) 
Format name Char(8) 
Server name qualifier Char(*) 
Length of server name qualifier Binary(4) 
Error Code Char(*) 


1 
2 
3 
4 
5 
6 
7 
8 


Default Public Authority: *USE 


Threadsafe: No 


The Open List Network Servers (QFPADOLS) API retrieves a list of servers. The functions provided by 
this API are similar to the Work with Network Server Status (WRKNWSSTS) command. 


Authorities and Locks 


Network Server Description Authority 
*USE 

Network Server Description Lock 
*EXCLRD 


Required Parameter Group 


Receiver variable 
OUTPUT; CHAR(*) 


The receiver variable that receives the information requested. You can specify the size of the area 
to be smaller than the format requested as long as you specify the length parameter correctly. As a 
result, the API returns only the data the area can hold. 


Length of receiver variable 
INPUT; BINARY(4) 
The length of the receiver variable provided. The length of the receiver variable parameter may be 
specified up to the size of the receiver variable specified in the user program. If the length of the 


receiver variable parameter specified is larger than the allocated size of the receiver variable 
specified in the user program, the results are not predictable. The minimum length is 0 bytes. 


List information 


OUTPUT; CHAR(80) 


Information about the list created by this program. For a description of the layout of this parameter, 
see Format of List Information. 


Number of records to return 
INPUT; BINARY(4) 


The number of records in the list to put into the receiver variable. The value must be 0 or greater. 
Format name 
INPUT; CHAR(8) 


The format of the information returned. You must use the following format name: 


DOLSO100 The output server list structure for Windows servers. For more information, see 
DOLS0O100 Format. 


Server name qualifier 
INPUT; CHAR(*) 
A restriction on the information to be retrieved. This parameter allows the caller to request a subset 


of the entries that normally would be returned on a given format. If this parameter is *ALL, no 
information qualification is performed. Allowable values are: 


*ALL Information about all servers. 
Server name Information about the specified server name entry only. 


Generic server name* Information about servers matching the generic server name string. 


Length of server name qualifier 
INPUT; BINARY(4) 


The length of the server name qualifier. 
Error code 
1/0; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. If this parameter is omitted, diagnostic and escape messages are issued to the 
application. 


DOLS0100 Format 


Format DOLSO100 returns Windows server information. 


| Offset 
| Dec Hex /|Type Field 


| 0 0 BINARY(4) Displacement to next server entry 
| 4 4 BINARY(4) Length of server entry 
| 8 8 CHAR(8) Network server description (NWSD) name 


[17 | 11 |CHARG) [Reserved SCS 
[28 | IC |BINARY@) [Displacement to domainname ——~—S 
a RETO [Length of serverdescription ——~—S—S 
za 2C BINARY(@)_[iepacemene DNS comin one 

[er [2 feHARG) [Revered 


BINARY(4) Displacement to list of iSeries Integration hot 
fix entries 


[ 88 | 5 [BIN ARY(4) [Length of an iSeries Integration hot fix entry 
= | SC [BINARY(4) [Number of iSeries Integration hot fix entries * 


See See |CHAR(*) Server name 
note note 
See See |CHAR(*) Domain name 
note note 
See See |CHAR(*) Server description 
note note 
See See |CHAR(*) DNS domain name 
note note 
These fields CHAR(7) iSeries Pee | hot fix 
repeat for each 
iSeries 
Intseration hot = a 
fix. 


Note: The displacement to the server name, domain name, server description, DNS 
domain name, #*and hot fix *€ are specified in the respective displacement 


variables. 


Field Descriptions 


Displacement to DNS domain name. The displacement in bytes from the beginning of the record to the 
domain name of the Domain Name System (DNS). 


Displacement to domain name. The displacement in bytes from the beginning of the record to the domain 
name. 


2Displacement to list of iSeries Integration hot fix entries. The displacement to the first entry in the 
iSeries Integration hot fix list.“ 


Displacement to next server entry. The displacement in bytes from the beginning of the record to the next 
server entry. If this is the last entry, this value will be zero. 


Displacement to server description. The displacement in bytes from the beginning of the record to the 
server description. 


Displacement to server name. The displacement in bytes from the beginning of the record to the server 
name. 


DNS domain name. The domain name system (DNS) domain name of this server. 
Domain name. The domain name of this server. 


2Hardware resource model. The hardware resource model of the input/output processor (IOP) or 
input/output adapter (IOA) for the server. 


Hardware resource name. The hardware resource name of the input/output processor (IOP) or 
input/output adapter (IOA) for the server. 


Hardware resource type. The hardware resource type of the input/output processor (IOP) or input/output 
adapter (IOA) for the server. 


iSeries Integration hot fix. The identifier for an iSeries Integration for Windows Server hot fix that is 
installed on the server. 


iSeries Integration service pack. The identifier for an iSeries Integration for Windows Server service pack 
that is installed on the server. 


iSeries Integration version. The version number of the iSeries Integration for Windows Server product 
that is installed on the server. The value has the format VxRyMz, where x is the version, y is the release, 
and z is the modification. 

Length of an iSeries Integration hot fix entry. The length of one iSeries Integration hot fix entry. 
Length of DNS domain name. The length of this DNS domain name. 

Length of domain name. The length of this domain name. 

Length of server description. The length of this server description. 

Length of server entry. The length of this server entry. 

Length of server name. The length of this server name. 


Network server description (NWSD) name. The name of the network server description. 


Number of iSeries Integration hot fix entries. The number of times the iSeries Integration hot fix 
entries are repeated.*& 


Reserved. Reserved space. 
Server description. The server description. 


Server name. The name of this server. 


Server status. The status of the server. The possible values follow: 
0 Active 


1 Inactive 


2 Restricted 
3 Pending 

4 Unknown 
5 Ending 
6 Failed 


7 Partially shut down 


Format of List Information 


The following table shows the format of the list information parameter. For detailed descriptions of the 
field in the table, see Field Descriptions. 


| Offset 
es c || Hex |Type Field 


| [BIN ARY(4) [Total records 

| 4 | 4 [BIN ARY(4) [Records returned 

| 8 | 8 [CHAR(4) [Request handle 

| 12 | C [BIN ARY(4) [Record length 

| 16 | 10 |CHAR(1) [Information complete indicator 
| 17 | 11 [CHAR(13) [Date and time created 

| 30 | 1E |CHAR(1) [List status indicator 

| 31 | 1F |CHAR(1) [Reserved 

| 32 | 20 [BINARY(4) [Length of information returned 
| 36 | 24 [BIN ARY(4) [First record in buffer 

| 40 | 28 |CHAR(40) [Reserved 


Field Descriptions 


Date and time created. The date and time the list was created. The 13 characters are: 
vi Century, where 0 indicates years 19xx and 1 indicates years 20xx. 
2-7 The date, in YYMMDD (year, month, day) format. 


S-13 The time of day, in HHMMSS (hours, minutes, seconds) format. 


First record in buffer. The number of the first record in the receiver variable. 
Information complete indicator. Whether all information requested has been supplied. 


I Incomplete information. An interruption caused the list to contain incomplete information about a 
buffer or buffers. 


P Partial and accurate information. Partial information is returned when the maximum space was used 
and not all of the buffers requested were read. 


C Complete and accurate information. All the buffers requested were read and returned. 


Length of information returned. The size, in bytes, of the information returned in the receiver variable. 
List status indicator. The status of the list building. The indicators are: 

0 The list building is pending. 

I The list is in the process of being built. 

2 The list has been built completely. 


3 Anerror occurred while building the list. The next call to QGYGTLE will cause the error to be 
signalled to the caller of QGYGTLE. 


Record length. The length of each record of information returned. For variable length records, this value is 
set to 0. For variable length records, you can obtain the length of individual records from the records 
themselves. 


Records returned. The number of records returned in the receiver variable. This is the smallest of the 
following values: 

e@ The number of records that fit into the receiver variable. 

e The number of records in the list. 

e The number of records requested. 


Request handle. The handle of the request that can be used for subsequent requests of information from the 
list. The handle is valid until the Close List (QGYCLST) API is called to close the list or until the job ends. 


Note: This field should be treated as a hexadecimal field. It should not be converted from one CCSID to 
another (for example, EBCDIC to ASCII) because doing so could result in an unusable value. 


Reserved. Reserved field. Must be set to hexadecimal or binary zero. 


Total records. The total number of records available in the list. 


Error Messages 


Message ID Error Message Text 
CPF24B4 E Severe error while addressing parameter list. 
2*CPF2625 E Not able to allocate object & 1.4% 


CPF2634 E 

CPF3C17 E 
CPF3C19 E 
CPF3C1D E 
CPF3C1E E 
CPF3C1F E 
CPF3C21E 
CPF3C24 E 
CPF3CF1 E 
CPF3CF2 E 
CPF3C36 E 
CPF9806 E 

CPF9872 E 


Not authorized to object &1. 

Error occurred with input data parameter. 

Error occurred with receiver variable specified. 

Length specified in parameter &1 not valid. 

Required parameter &1 omitted. 

Pointer is not on a 16 byte boundary. 

Format name &1 is not valid. 

Length of the receiver variable is not valid. 

Error code parameter not valid. 

Error(s) occurred during running of &1 API. 

Number of parameters, &1, entered for this API was not valid. 
Cannot perform function for object &2 in library &3. 

Program or service program &1 in library &2 ended. Reason code &3. 


Note: CPF2634 and CPF2625 messages are returned in the error code parameter, and are not signaled.*& 


API introduced: V4R5 


Top | Server Support APIs | APIs by category 


Process Network Server User (QFPADPNU) API 


Required Parameter Group: 


Option Char(10) 
Profile type Char(10) 
Profile name Char(10) 
Windows domain name Char(*) 
Length of Windows domain name Binary(4) 
Windows server name Char(*) 
Length of Windows server name Binary(4) 
Error code Char(*) 


1 
2, 
3 
4 
5 
6 
7 
8 


Default Public Authority: *USE 


Threadsafe: No 


The Process Network Server User (QFPADPNU) API performs an error recovery operation on a selected 
user or group enrollment entry for a particular Windows domain or server. 


Enrollment and unenrollment requests can fail for various reasons. If an enrollment or unenrollment request 
has failed, the administrator can correct the error and then use this API with the *RETRY option to retry the 
failed enrollment or unenrollment request. If an unenrollment request has failed and the error cannot be 
corrected, the administrator can use this API with the *REMOVE option to remove the user or group from 
the list of enrolled users or groups for a domain or server. 


Authorities and Locks 


User profile 
*READ 


Required Parameter Group 


Option 
INPUT; CHAR(10) 


The type of operation to be performed. You must use one of the following options: 


*REMOVE This option removes the entry from the list of users or groups that are enrolled to a 
Windows domain or server. This option is only valid for those entries that are in 
the process of being unenrolled (status of unenrollment pending, unenrollment 
retry pending, or unenrollment failed). 


For example, if an unenrollment request failed because the server that the user was 
enrolled to no longer exists, then the administrator could use the “REMOVE 
option of this API to remove the user from the enrollment list for that server. 


*RETRY This option immediately retries the enrollment request to the Windows domain or 
server. This option is normally used after an enrollment or unenrollment request 
has failed and the reason for the failure has been corrected. 


For example, if an enrollment request failed because the user template does not 


exist on the server, then the administrator could create the user template and then 
use the *RETRY option of this API to reattempt the enrollment request. 


Profile type 
INPUT; CHAR(10) 


Whether profile information is for a user profile or group profile. Values can be: 
*USER The profile information is for a user profile on the selected domain or server. 


*GROUP The profile information is for a group profile on the selected domain or server 


Profile name 
INPUT; CHAR(10) 


The name of the profile to process. Allowable values are: 


Profile name Perform the operation for the specified user or group profile. 


Usage note: Avoid the use of characters 'SB'X, '7B'X, and '7C'X (CCSID 37 characters '$', '#', and 
‘@', respectively) in profile names. 


Windows domain name 
INPUT; CHAR(*) 


The name of the Windows domain to process. Allowable values are: 
*NONE No domain is to be processed. 


Domain name _ Perform the operation for the specified domain. 


Length of Windows domain name 
INPUT; BINARY(4) 


The length of the Windows domain name. 
Windows server name 
INPUT; CHAR(*) 


The name of the Windows server to process. Allowable values are: 
*NONE No server are to be processed. 


Server name Perform the operation for the specified server. 


Length of Windows server name 
INPUT; BINARY(4) 


The length of the Windows server name. 


Error code 


1/0; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. If this parameter is omitted, diagnostic and escape messages are issued to the 


application. 


Error Messages 


Message ID 
CPF24B4 E 
CPF2634 E 
CPF3C1D E 
CPF3C3C E 
CPF3CF1 E 
CPF3C36 E 
CPF9872 E 
CPF9999 E 


Error Message Text 

Severe error while addressing parameter list. 

Not authorized to object &1. 

Length specified in parameter &1 not valid. 

Value for parameter &1 not valid. 

Error code parameter not valid. 

Number of parameters, &1, entered for this API was not valid. 

Program or service program &1 in library &2 ended. Reason code &3. 
Function check. &1 unmonitored by &2 at statement &5, instruction &3. 


API Introduced: V5R1 


Top | Server Support APIs | APIs by category 


Retrieve Network Server Information 
(QFPADRNI) API 


Required Parameter Group: 


Receiver variable Char(*) 
Length of receiver variable Binary(4) 
Format name Char(8) 
NWSD server name Char(8) 
Error Code Char(*) 


Default Public Authority: *USE 


Threadsafe: No 


The Retrieve Network Server Information (QFPADRNI) API retrieves information from a Windows server. 
The amount of information returned depends on the size of the variable. The information returned is similar 
to the information returned by the Work with Network Server Status (WRKNWSSTS) command's option 5, 
Display details. 


Authorities and Locks 


Network Server Description Authority 
*USE 

Network Server Description Lock 
*EXCLRD 


Required Parameter Group 


Receiver variable 
OUTPUT; CHAR(*) 
The variable to receive the network server information. You can specify the size of this area to be 


smaller than the format requested as long as you specify the length parameter correctly. As a result, 
the API returns only the data that the area can hold. 


Length of receiver variable 
INPUT; BINARY(4) 
The length of the receiver variable. If the length is larger than the size of the receiver variable, the 
results may not be predictable. The minimum length is 8 bytes. 
Format name 
INPUT; CHAR(8) 


The format of the network server information to be returned. The valid format names are: 


DRNIO100_ Returns information about the Windows server version and the iSeries Integration 
with Windows Server version. 


DRNIO200_ Returns information about the Windows server's current status. 


NWSD server name 
INPUT; CHAR(8) 
The name of the NWSD for which to retrieve information. The name must be specified in upper 
case characters and padded with blanks to a full 8 characters. 
Error code 
I/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


DRNIO100 Format 


The DRNIO100 format returns network server version information. 


| Offset 
pe HE c | Hex |Type Field 


| | [BINARY(4) [Bytes returned 

| 4 | 4 [BINARY (4) [Bytes available 

| 8 | 8 [CHAR(10) [Windows version 

| 18 | 12 |[CHAR(10) [Windows build number 

| 28 | 1C |CHAR(128) [Windows service pack level 
| 156 | 9C [CHAR(6) [iSeries Integration version 

| 162 | A2 [CHARG8) [Reserved 


200 C8  |BINARY(4) Offset to list of iSeries Integration service pack 
entries 
204 CC |BINARY(4) Length of an iSeries Integration service pack 
entry 
208 DO |BINARY(4) Number of iSeries Integration service pack 
| | eee 


| 212 D4 _ =S|BINARY(4) [Offset to list of iSeries Integration hot fix entries 
| 216 D8 [BINARY(4) [Length of an iSeries Integration hot fix entry 
| 220 DC |BINARY(4) [Number of iSeries Integration hot fix entries * 


rman [Ses Integration service pack 
i po 


These fields |CHAR(7) iSeries Integration hot fix 
repeat for each 

iSeries 

ee hot |CHARG) Reserved*& 


DRNIO200 Format 


The DRNIO200 format returns network server status information. 


| Offset 
| D Hex |Type Field 


7 1 po hese FCs 
[ 4 | 4  [BINARY(4) [Bytesavailable = = ss 
[ 8 | 8 |BINARY(4) |Connectedusers == —(i‘:™C~C~™S 
[ 12 | C  |BINARY(4) |Processorused = s—<—sS 
[ 16 | 10 |BINARY(4) |Pagingfileused == s— 
ee BINARY(4) |Registryquotaused = ss—S 
[ 18 |BINARY(4) [Offset to list of multiple processor usage entries _ 
Ee BINARY(4) [Length of a multiple processor usage entry 
[ 32 | 20 |BINARY(4) [Number of multiple processor usage entries 


This field repeats |BINARY(4) Multiple processor usage 
for each multiple 


processor usage 


entry 


Field Descriptions 


Bytes available. The length of all data available for the requested format. All available data is returned if 
enough space is provided. 


Bytes returned. The length of all data actually returned. If the data is truncated because the receiver 
variable is not large enough to hold the data, this value is less than the bytes available. 


Connected users. Number of user connections currently present on this server. 


“Series Integration hot fix. The identifier for an iSeries Integration for Windows Server hot fix that is 
installed on the server.*& 


iSeries Integration service pack. The identifier for an iSeries Integration for Windows Server service pack 
that is installed on the server. 


iSeries Integration version. The version number of the iSeries Integration for Windows Server product 
that is installed on the server. The value has the format VxRyMz, where x is the version, y is the release, 
and z is the modification. 


Length of a multiple processor usage entry. The length of one multiple processor usage entry. 
2Length of an iSeries Integration hot fix entry. The length of one iSeries Integration hot fix entry.“ 


Length of an iSeries Integration service pack entry. The length of one iSeries Integration service pack 
entry. 


Multiple processor usage. The percent usage for servers that support multiple processors. This number is 
the processor usage value for an individual processor, represented as an integer value between 0 and 100. A 
usage value is returned for each processor, so the number of values returned depends on the number of 
processors on the server. 


2*Number of iSeries Integration hot fix entries. The number of times the iSeries Integration hot fix 
entries are repeated.“ 


Number of iSeries Integration service pack entries. The number of times the iSeries Integration service 
pack entries are repeated. 


Number of multiple processor usage entries. The number of times the multiple processor usage entries 
are repeated. 


Offset to list of iSeries Integration hot fix entries. The offset to the first entry in the iSeries Integration 
hot fix list.“ 


Offset to list of iSeries Integration service pack entries. The offset to the first entry in the iSeries 
Integration service pack list. 


Offset to list of multiple processor usage entries. The offset to the first entry in the multiple processor 
usage list. 


Paging file used. The percentage of the server paging file used. This percentage is expressed as an integer 
value between 0 and 100. 


Processor used. The percentage of the server's processor used. This percentage is expressed as an integer 
value between 0 and 100. 


If the server supports a single processor, this number is the usage for the individual processor. If the server 
supports multiple processors, this number is the average processor usage for all of the processors. 


Registry quota used. The percentage of the server's registry used. This percentage is expressed as an 
integer value between 0 and 100. 


Reserved. Reserved space. 
Windows build number. The current build number of the Windows operating system on the server. 


Windows service pack level. The current service pack level of the Windows operating system on the 
server. 


Windows version. The current version of the Windows operating system on the server. 


Error Messages 


Message ID 
= CPFOC4A E 
CPF24B4 E 
CPF2625 E 
CPF2634 E 
CPF3C17E 
CPF3C19 E 
CPF3C21E 
CPF3C24 E 
CPF3CFI1 E 
CPF9806 E 
CPF9872 E 


Error Message Text 

Product record not found.*& 

Severe error while addressing parameter list. 

Not able to allocate object &1. 

Not authorized to object &1. 

Error occurred with input data parameter. 

Error occurred with receiver variable specified. 
Format name &1 is not valid. 

Length of the receiver variable is not valid. 

Error code parameter not valid. 

Cannot perform function for object &2 in library &3. 
Program or service program &1 in library &2 ended. Reason code &3. 


API introduced: V4R5 


Top | Server Support APIs | APIs by category 


Retrieve Network Server User Attributes 
(QFPADRUA) API 


Required Parameter Group: 


Receiver variable Char(*) 
Length of receiver variable Binary(4) 
Format name Char(8) 
Profile name Char(10) 
Error code Char(*) 


Default Public Authority: *USE 


Threadsafe: No 


The Retrieve Network Server User Attributes (QFPADRUA) API retrieves the network server attributes for 
a user or a group. The functions provided by this API are similar to the Display Network Server User 
Attributes (DSPNWSUSRA) command. 


Authorities and Locks 


User profile 
*READ 


Required Parameter Group 


Receiver variable 
OUTPUT; CHAR(*) 
The receiver variable that receives the information requested. You can specify the size of the area 


to be smaller than the format requested as long as you specify the length parameter correctly. As a 
result, the API returns only the data the area can hold. 


Length of receiver variable 
INPUT; BINARY(4) 
The length of the receiver variable provided. The length of the receiver variable parameter may be 
specified up to the size of the receiver variable specified in the user program. If the length of the 


receiver variable parameter specified is larger than the allocated size of the receiver variable 
specified in the user program, the results are not predictable. The minimum length is 8 bytes. 


Format name 
INPUT; CHAR(8) 


The format of the information returned. Indicates whether this call is interested in the user 


characteristics of the profile or the group characteristics of the profile. Profiles can behave as both 
user and group profiles, and unique enrollment characteristics can be set for each aspect of the 
profile. You must use one of the following format names: 


DRUAOIO0 The output network server user attributes structure. For more information, see 
DRUAO100 Format. 


DRUAO200 The output network server group attributes structure. For more information, see 
DRUAO200 Format. 


Profile name 
INPUT; CHAR(10) 


The name of the user or group profile whose network server attributes are to be retrieved. The 
values can be: 


*NWSA The system default network server attributes defined by the Change Network Server 
Attributes (CHGNWSA) command are retrieved. This value is allowed only when 
format DRUAO100 is specified. 


Name The network server attributes for the specified user or group profile are retrieved. 


Usage note: Avoid the use of characters 'SB'X, '7B'X, and '7C'X (CCSID 37 characters '$', '#', and 
‘@’, respectively) in profile names. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. If this parameter is omitted, diagnostic and escape messages are issued to the 
application. 


Format of the Retrieved Information 


The formats of the information retrieved by this API are listed below. The caller should pass a receiver 
variable large enough to handle most requests. On return, the bytes available field of the receiver variable 
will contain the required size of the receiver variable to hold all information from the request. If this is 
greater than the original receiver variable size passed in, then the caller must allocate a larger receiver 
variable before retrying the operation. 


DRUA0100 Format 


The following table shows the format of the network server user attributes. 


| Offset 
| Dec Hex /Type Field 


| 0 0 BINARY(4) Bytes returned 
| 4 4 BINARY(4) Bytes available 
| 8 8 CHAR(12) Reserved 


a 1c BINARY(@)—[NemberWindows demas 
Sear SNETO [Length Windows server entries —~—~S~*S 


See See |See Format of |Windows domain list 
note note Windows 

See See 

note note 


domain 
information 

Note:The offsets to the Windows domain list and Windows server list are specified 

in the offset Windows domain list and offset Windows server list variables, 


See Format of }|Windows server list 
Windows 

server 

information 


respectively. 


DRUAO200 Format 


The following table show the format of the network server group attributes. 


| Offset 
| Dec | Hex /|Type Field 


[ 0 | 0 [BINARY(@) [Bytesreturned = = = = 
[ 4 | 4  [BINARY(4) [Bytesavailable = = = = = 
| 8 [8 _[CHARCO) [Group member enrolment 
a9 | BINARY) — [ofise Windows domaiw lg 
| 24 | 18 |BINARY() — [Length Windows domainentries = 
| 28 [ IC |BINARY(4) [Number Windowsdomains = 
[ 32 | 20 |BINARY(4) Offset Windows serverlist = 
| a 

[| #0 [28 (BINARY) _[Number Windows seners 


i ae ° ne 
° ne ° eee 


Windows 
domain 
information 


See Format of |Windows server list 
Windows 

server 

information 


Note: The offsets to the Windows domain list and Windows server list are specified 
in the offset Windows domain list and offset Windows server list variables, 


respectively. 


DRUA0100 and DRUA0200 Field Descriptions 


Bytes available. The length of all data available for the requested format. All available data is returned if 
enough space is provided. 


Bytes returned. The length of all data actually returned. If the data is truncated because the receiver 
variable is not large enough to hold the data, this value is less than the bytes available. 


Group member enrollment. This field indicates whether or not the group members (users in the group) 
are enrolled to the server. This field is only returned for format DRUA0200. The following are the valid 
values for this field: 


*ALL The group and the users in the group are enrolled to the servers. 


*MBRONLY Only the users in the group are enrolled to the servers. The group itself is not enrolled to 
the servers. 


*NONE Only the group is enrolled to the servers. The users in the group are not enrolled to the 
servers. 


Length Windows domain entries. The length in bytes of each element in the list of Windows domains. 
Length Windows server entries. The length in bytes of each element in the list of Windows servers. 


Number Windows domains. The number of entries in the list of Windows domain names. If this value is 
O, then there are no Windows domains in the list. 


Number Windows servers. The number of entries in the list of Windows server names. If this value is 0, 
then there are no Windows servers in the list. 


Offset Windows domain list. The offset from the start of the receiver variable to the list of Windows 
domain entries. A value of zero indicates there are no list entries. See Format of Windows domain 


information for details of the individual entries. 


Offset Windows server list. The offset from the start of the receiver variable to the list of Windows server 
entries. A value of zero indicates there are no list entries. See Format of Windows server information for 


details of the individual entries. 
Reserved. Reserved space. 


Windows domain list. The list of Windows domain entries. See Format of Windows domain information 
for details of the individual entries. 


Windows server list. The list of Windows server entries. See Format of Windows server information for 
details of the individual entries. 


Format of Windows domain information 


The following table describes the layout of the information returned to describe a Windows domain. To 
locate the first such entry, add the receiver variable start to the value in ‘Offset Windows domain list’ noted 
above. Each succeeding entry can be located by adding the 'Length Windows domain entries’ size to the 
address of the current entry. 


| Offset 
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zm See |CHAR(*) Windows domain name 

Note Note 

See See |CHAR(*) Windows user template name 
Note Note 


Note: The displacement to the Windows domain name and Windows user template 
name are specified in the displacement to Windows domain name and displacement 


to Windows user template name variables, respectively. 


Windows Domain Field Descriptions 


Displacement to Windows domain name. The displacement in bytes from the beginning of the entry to 
the Windows domain name. 


Displacement to Windows user template name. The displacement in bytes from the beginning of the 
entry to the Windows user template name. 


Length of Windows domain name. The length of the Windows domain name. 

Length of Windows user template name. The length of the Windows user template name. 

Reserved. Reserved space. 

Windows domain name. This is the name of a domain in which the user is enrolled. The values can be: 


*NWSA The user is enrolled to the system default domains that are defined by the Change Network 
Server Attributes (CHGNWSA) command. 


Name The specific name of the domain in which the user is enrolled. 


Windows group type. This is the type of group created on a Windows domain. 
The values can be: 


*GLOBAL A global group was created. 


*LOCAL _ A local group was created. 


blank Blanks are returned if retrieving user attributes. 


Windows user template name. The name of a Windows user that was used as a template when creating 
the specified user on Windows. The values can be: 


*NONE No user template was used when creating the specified user. 


Name The specific name of the user template that was used when creating the specified user. 


Format of Windows server information 


The following table describes the layout of the information returned to describe a Windows server. To 
locate the first such entry, add the receiver variable start to the value in 'Offset Windows server list' noted 
above. Each succeeding entry can be located by adding the Length Windows server entries' size to the 
address of the current entry. 


| Offset 
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La See |CHAR(*) Windows server name 

Note Note 
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Note: The displacement to the Windows server name and Windows user template 
name are specified in the displacement to Windows server name and displacement 


to Windows user template name variables, respectively. 


Windows Server Field Descriptions 


Displacement to Windows server name. The displacement in bytes from the beginning of the entry to the 
Windows server name. 


Displacement to Windows user template name. The displacement in bytes from the beginning of the 
entry to the Windows user template name. 


Length of Windows server name. The length of the Windows server name. 
Length of Windows user template name. The length of the Windows user template name. 


Windows server name. The name of a server in which the user is enrolled. The values can be: 


*NWSA The user is enrolled to the system default servers that are defined by the Change Network 
Server Attributes (CHGNWSA) command. 


Name The specific name of the server in which the user is enrolled. 


Windows user template name. The name of a Windows user that was used as a template when creating 
the specified user on Windows. The values can be: 


*NONE No user template was used when creating the specified user. 


Name The specific name of the user template that was used when creating the specified user. 


Error Messages 


Message ID 
CPF2204 E 
CPF24B4 E 
CPF2634 E 
CPF3C19 E 
CPF3C21E 
CPF3C24 E 
CPF3C3C E 
CPF3CF1 E 
CPF9872 E 
CPF9999 E 


Error Message Text 

User profile &1 not found. 

Severe error while addressing parameter list. 

Not authorized to object &1. 

Error occurred with receiver variable specified. 

Format name &1 is not valid. 

Length of the receiver variable is not valid. 

Value for parameter &1 not valid. 

Error code parameter not valid. 

Program or service program &1 in library &2 ended. Reason code &3. 
Function check. &1 unmonitored by &2 at statement &5, instruction &3. 


API Introduced: V5R1 
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DHCP Address Binding Notification Exit 
Program 


Required Parameter Group: 


Request type Binary(4) 
Client IP address Char(*) 
Length of IP address Binary(4) 
Client identifier Char(*) 
Length of client identifier Binary(4) 
Lease duration Binary(4) 
Response packet Char(*) 
Length of response packet Binary(4) 


1 
2 
3 
4 
5 
6 
7 
8 


Exit Point Name: QIBM_QTOD_DHCP_ABND 


Exit Point Format Name: DHCA0100 


The DHCP Address Binding Notification exit program allows for notification each time the DHCP server 

assigns an IP address to a specific client host. This is known as address binding. The exit program will be 

called any time the DHCP server sends an acknowledgement packet (known as a DHCP ACK) to a DHCP 
client or sends a Bootstrap Protocol (BOOTP) reply packet to a BOOTP client. The two possible client IP 
address binding packets follow: 


1. A DHCP ACK from the server tells a DHCP client that it has been granted a lease to use a specific 
IP address for a specific period of time. Acknowledgements are sent when a DHCP client accepts 
an initial offer of an IP address made by the server, as well as each time that a DHCP client asks for 
the renewal of an existing IP address lease and the server grants it. 


2. A BOOTP reply packet is sent from the server in response to a BOOTP request packet from a client 
if the server decides to assign an IP address to that client. The BOOTP reply notifies the BOOTP 
client what IP address it has been assigned. Unlike DHCP, the BOOTP protocol does not support 
the concept of temporary leasing. Therefore, the address binding to the BOOTP client is considered 
permanent and there will be no ongoing exchange of renewal bindings. The DHCP server internally 
treats a BOOTP client binding as an infinite lease. 


When an exit program is added to the exit point, it is called immediately after the DHCP server has 
transmitted one of the client IP address binding packets described above. This is for notification purposes 
only, and no data is expected to be sent back to the DHCP server from the exit program. The exit program 
will be sent information about the protocol type (DHCP or BOOTP), the identity of the client, the IP 
address, and the duration of the lease. In addition, a copy of the actual packet that was transmitted will be 
sent. 


Note: Since this is an exit point of the DHCP server, the exit program can only be used to obtain 
notification of address bindings for the BOOTP client if the DHCP server is running. It cannot be used to 
obtain notification of IP address assignments for the BOOTP client made by the iSeries BOOTP server. 


Required Parameter Group 


Request type 
INPUT; BINARY(4) 


The type of request protocol being used between the client and server. The possible values are: 


I DHCP 
2 BOOTP 


Client IP address 
INPUT; CHAR(*) 
The Internet Protocol (IP) address that was bound to the client host. This string is in dotted decimal 
format and left-justified. 
Length of client IP address 
INPUT; BINARY(4) 


The length (in bytes) of the client IP address. 
Client identifier 
INPUT; CHAR(*) 
The unique identifier of the client that the IP address has been bound to. This is usually the 
hardware address of the client machine. 
Length of client identifier 
INPUT; BINARY(4) 


The length (in bytes) of the client identifier string. 
Lease duration 
INPUT; BINARY(4) 


The duration (in seconds) of the lease period for which the client may now use the IP address. 


This field should be treated as a 32-bit unsigned number. The special value follows: 


hex FFFFFFFF ff all 32 bits are set to 1, this indicates that the lease is an infinite lease, which 
does not expire. 


Response packet 
INPUT; CHAR(*) 


This is the DHCP or BOOTP message response packet that was transmitted from the DHCP server 
to the client host just prior to this notification exit program being called. 


The formats of the packets are defined and maintained by the Internet Engineering Task Force 
(IETF) standards body. Refer to the following IETF Request For Comments (RFC) documents for 
the specifications: 


Oo RFC 951, Bootstrap Protocol (BOOTP) 
oOo RFC 1542, Clarifications and Extensions for the Bootstrap Protocol 


oO RFC 2131, Dynamic Host Configuration Protocol 
oO RFC 2132, DHCP Options and BOOTP Vendor Extensions 
Note: Since the packet is presented to the exit program just as it was transmitted on the network, it 


should be noted that any data areas of the packet that are defined as type string or character by the 
RFCs will be US-ASCII. On the iSeries, it is recommended that this data be treated as CCSID 819. 


Length of response packet 
INPUT; BINARY(4) 


The length (in bytes) of the response packet. 


Exit program introduced: V4R2 
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DHCP Address Release Notification Exit 
Program 


Required Parameter Group: 


Reason for release Input Binary(4) 
Client IP address Input Char(*) 
Length of client IP address Input Binary(4) 


Client identifier Input Char(*) 
Length of client identifier Input Binary(4) 


Exit Point Name: QIBM_QTOD_DHCP_ARLS 


Exit Point Format Name: DHCRO100 


The DHCP Address Release Notification exit program allows for notification each time the DHCP server 
releases an IP address from its specific client host assignment binding. 
An address could have been released from the client that it was bound to for one of the following reasons: 
1. The client explicitly sent a DHCP RELEASE request to the DHCP server. 
2. The lease duration that the client was last given for using the IP address has expired. 
3. A DHCP server administrator has explicitly released the IP address. 
When an exit program is added to the exit point, it is called whenever the DHCP server releases an IP 
address from the specific client host that it had been assigned to. This is for notification purposes only, and 
no data is expected to be sent back to the DHCP server from the exit program. The exit program will be 


sent information about the IP address, the identity of the client, and the reason for the IP address being 
released. 


Required Parameter Group 


Reason for release 
INPUT; BINARY(4) 


A reason that the DHCP server has released the IP address from being bound to the specific client 
host. The possible values are: 


1 The DHCP server received a DHCP RELEASE packet from the client. 
2 The duration of the lease that the client was last given for use of the IP address has expired. 


3 The release is forced by DHCP server administrator. 


Client IP address 
INPUT; CHAR(*) 


The Internet Protocol (IP) address that was just released from its client host binding. This string is 
in dotted decimal format and left-justified. 


Length of client IP address 
INPUT; BINARY(4) 


The length (in bytes) of the client IP address. 
Client identifier 
INPUT; CHAR(*) 


The unique identifier of the client from which the IP address has been released. This is usually the 
hardware address of the client machine. 


Length of client identifier 
INPUT; BINARY(4) 


The length (in bytes) of the client identifier string. 


Exit program introduced: V4R2 
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DHCP Request Packet Validation Exit Program 


Required Parameter Group: 


Request packet Input Char(*) 
Length of request packet Input Binary(4) 


Allow operation Output Binary(4) 


Exit Point Name: QIBM_QTOD_DHCP_REQ 


Exit Point Format Name: DHCV0100 


The Dynamic Host Configuration Protocol (DHCP) Request Packet Validation exit program provides 
additional control for restricting which incoming DHCP and Bootstrap Protocol (BOOTP) message request 
packets from client hosts are processed by the DHCP server, and which should be rejected. Any restrictions 
that are imposed by the exit program are in addition to any validation that is performed by the DHCP server 
program through its configuration options. When an exit program is added to the exit point, it is called by 
the DHCP server each time an incoming DHCP or BOOTP request packet is received, but before any 
processing of the packet has taken place. The packet data is passed to the exit program just as it was 
received off the network without any additional formatting or data conversion. The exit program sets the 
allow operation parameter to indicate whether the DHCP server should continue with normal processing of 
the request packet. If the exit program indicates that the request packet should be rejected, the DHCP server 
will discard the packet without any further processing. 


Note: Since this is an exit point of the DHCP server, the exit program can only be used to restrict BOOTP 
packets if the DHCP server is running. It cannot be used to restrict BOOTP packets from being processed 
by the BOOTP server. 


Required Parameter Group 


Request packet 
INPUT; CHAR(*) 


The DHCP or BOOTP message request packet that was initiated from some client host and 
received by the DHCP server. It is in its initial form, which is how it comes off of the network. 


The formats of the packets are defined and maintained by the Internet Engineering Task Force 
(IETF) standards body. Refer to the following IETF Request For Comments (RFC) documents for 
the specifications: 


oO RFC 951, Bootstrap Protocol (BOOTP) 
oO RFC 1542, Clarifications and Extensions for the Bootstrap Protocol 
oO RFC 2131, Dynamic Host Configuration Protocol 
oO RFC 2132, DHCP Options and BOOTP Vendor Extensions 
Note: Since the packet is presented to the exit program just as it was received from the network, it 


should be noted that any data areas of the packet that are defined as type string or character by the 
RFCs will be US-ASCII. On the iSeries, it is recommended that this data be treated as CCSID 819. 


Length of request packet 
INPUT; BINARY(4) 


The length (in bytes) of the request packet. 
Allow operation 
OUTPUT; BINARY(4) 


Whether the DHCP server should continue processing the request packet, or whether it should be 
rejected. The possible values are: 


O The request packet should be rejected 


I Processing of the request packet should be allowed to continue 


Exit program introduced: V4R2 
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